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内 容 简 介 


本 书 循 序 渐进 地 讲解 了 Android 网 络 开发 技术 的 基本 知识 ， 内 容 新 颖 、 知 识 全 面 、 讲 解 详细 。 全 书 共 
分 16 章 ， 第 1 一 2 章 是 基础 知识 ， 讲 解 Android 基础 和 Android 网 络 开 发 基础 ， 第 3 章 详细 讲解 HTTP 通 
信 处 理 的 基本 知识 ; 第 4 章 详细 讲解 URL 处 理 的 实现 过 程 ， 第 5 章 详细 讲解 为 Android 开发 网 页 的 实现 
WE: 第 6 章 讲解 WebKit 浏览 器 的 基本 知识 ; 第 7 章 讲解 在 Android 中 开发 蓝牙 应 用 的 基本 知识 ; 第 8 
章 讲解 在 Android 中 开发 Wi-Fi 应 用 的 基本 知识 ; 第 9 章 讲解 在 Android 中 开发 RSS 应 用 的 基本 知识 ; 第 
10 章 讲解 在 Android 中 开发 电子 邮件 应 用 的 基本 知识 ; 第 11 章 讲解 让 网 络 和 多 媒体 接轨 的 基本 知识 ; 第 
12 章 讲 解 在 Android 中 开发 移动 微 博 应 用 的 基本 知识 ; 第 13 章 讲解 开发 Android 流量 统计 系统 的 基本 知 
VA: 第 14 章 讲解 开发 Android 流量 监控 系统 的 基本 知识 ; 第 15 章 和 第 16 章 是 两 个 综合 实例 ， 分 别 讲解 
开发 流量 监控 系统 和 电子 邮件 系统 的 基本 流程 。 书 中 的 每 个 实例 都 遵循 先 提出 制作 思路 及 包含 知识 点 ， 
再 在 实例 最 后 补充 总 结 知识 点 并 引导 读者 举一反三 。 
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Foreword 


进入 21 世纪 以 来 ， 整 个 社会 开始 发 生 了 深刻 的 变化 。 生 活 和 工作 的 快 节奏 令 我 们 目 不 
暇 接 ， 各 种 各 样 的 信息 充斥 着 我 们 的 视野 、 接 击 着 我 们 的 思维 。 追 忆 过 去 ，Windows 操作 
系统 的 诞生 成 就 了 微软 的 霸主 地 位 ， 也 造就 了 PC 时 代 的 繁荣 。 然 而 ， 以 Android 和 iPhone 
手机 为 代表 的 智能 移动 设备 的 发 明 却 敲 响 了 PC 时 代 的 警钟 ! 移动 互联 网 时 代 已 经 来 临 ， 谁 
会 成 为 这 些 移动 设备 的 主宰 ? 毫 无 疑问 ， 它 就 是 Android 一 一 PC 时 代 的 Windows! 


看 ICHRA 
随 着 3G 的 到 来 ,无 线 带宽 的 升 高 ， 使 得 更 多 内 容 丰 富 的 应 用 程序 安装 在 手机 上 成 为 可 


些 数据 应 用 及 快速 部 署 ， 手 机 功能 将 会 越 来 越 智能 ， 越 来 越 开放 。 为 了 实现 这 些 需 求 ， 必 
须 有 一 个 好 的 开发 平台 来 支持 ， 在 此 由 Google 公司 发 起 的 OHA 联盟 走 在 了 业界 的 前 列 ， 
于 2007 年 11 月 推出 了 开放 的 Android 平台 , 任何 公司 及 个 人 都 可 以 免费 获取 到 源 代 码 及 开 
发 SDK。 由 于 Android 系统 的 开放 性 和 优异 性 ，Android 平台 得 到 了 业界 广泛 的 支持 ， 其 中 
包括 各 大 手机 厂商 和 著名 的 移动 运营 商 等 。 继 2008 年 9 月 第 一 款 基于 Android 平台 的 手机 
Gl 发 布 之 后 ， 预 计 三 星 、 摩 托 罗 拉 、 索 爱 、LG、 华 为 等 公司 都 将 推出 自 Gflg-Android 平 
台 的 手机 ， 中 国 移动 也 联合 各 手机 厂商 共同 推出 基于 Android 平台 的 OPhone。 按 目前 的 发 
展 态 势 ， 我 们 有 理由 相信 ，Android 平台 将 在 短 时 间 内 跻身 智能 手机 开发 平台 前 列 。 

自从 2009 年 3G 牌照 在 国内 发 放 后 ，3G、Andriod、iPhone、Google、 苹 果 、 手 机 软件 、 
移动 开发 等 词 不 绝 于 耳 。 随 着 3G 网 络 的 大 规模 建设 和 智能 手机 的 迅速 普及 , 移动 互联 网 时 
代 已 经 微笑 着 迎面 而 来 。 

以 创新 的 搜索 引擎 技术 而 一 跃 成 为 互联 网 巨头 的 Google, 无 线 搜索 成 为 Google 进军 移 
动 互联 网 的 一 块 基石 。 早 在 2007 年 ，Google 中 国 就 把 无 线 搜索 当 作 战略 重心 ， 不 断 推出 新 
产品 ， 尝 试 通过 户外 媒体 推广 移动 搜索 产品 ， 并 积极 与 运营 商 、 终 端 厂 商 、 浏 览 器 厂商 等 
达成 战略 合作 。 

Android 操作 系统 是 Google 最 具 杀 伤 力 的 武器 之 一 。 苹果 以 其 天 才 的 创新 , 使 得 iPhone 
在 全 球 迅速 拥有 了 数 百 万 忠实 “粉丝 ”， 而 Android 作为 第 一 个 完整 、 开 放 、 免 费 的 手机 平 
台 ， 使 开发 者 在 为 其 开发 程序 时 拥有 更 大 的 自由 。 与 Windows Mobile, Symbian 等 厂商 不 
同 的 是 ，Android 操作 系统 免费 向 开发 人 员 提 供 ， 这 样 可 节省 近 三 成 成 本 ， 得 到 了 众多 厂商 
与 开发 者 的 拥护 。 自 从 2011 年 后 ，Android 就 一 直 是 市 场 占 有 率 最 高 的 智能 手机 系统 ， 并 
H. Android 的 成 功 也 造就 了 使 用 Android 系统 的 手机 制造 商 。 现 在 三 星 借助 Android 的 东风 ， 
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成 为 世界 上 发 货 量 最 大 的 手机 制造 商 。 


巨大 的 优势 


从 技术 角度 而 言 ，Android 与 iPhone 相似 ， 采 用 WebKit 浏览 器 引擎 ， 具 备 触 摸 屏 、 高 
级 图 形 显示 和 上 网 功能 ， 用 户 可 以 在 手机 上 查收 电子 邮件 、 搜 索 网 址 和 观看 视频 节目 等 。 
Android 手机 比 iPhone 等 其 他 手机 更 强调 搜索 功能 , 界面 更 强大 , 可 以 说 是 一 种 融入 了 全 六 
Web 应 用 的 平台 。 Android 的 版 本 包括 : Android 1.1. Android 1.5. Android 1.6. Android 2.0… 
当前 的 最 新 版 本 是 Android 4.2。 随 着 版 本 的 更 新 ， 从 最 初 的 触 屏 到 现在 的 多 点 触摸 ， 从 普 
通 的 联系 人 到 现在 的 数据 同步 ， 从 简单 的 GoogleMap 到 现在 的 导航 系统 ， 从 基本 的 网 页 浏 
览 到 现在 的 HTML 5, 这 都 说 明 Android 已 经 逐渐 稳定 , 而 且 功 能 越 来 越 强 大 。 此 外 , Android 
平台 不 仅 支 持 Java、C、C++ 等 主流 编程 语言 , 还 支持 Ruby. Python 等 脚本 语言 , 甚至 Google 
专 为 Android 的 应 用 开发 推出 了 Simple 语言 ， 这 使 得 Android 有 着 非常 广泛 的 开发 群体 。 


移动 网 络 的 优越 性 

网 络 应 用 的 最 大 优势 就 是 移动 互联 网 是 开放 的 ， 因 为 封闭 的 平台 (iPhone、iPad 等 ) 让 很 
多 开发 者 转身 离 去 ， 而 投奔 Android. Windows Mobile 等 平台 。 等 到 移动 设备 和 桌面 设备 一 
样 强大 的 时 候 ， 移 动 网 络 应 用 有 可 能 和 本 地 应 用 一 决 高 下 。 

在 现实 情况 下 ， 有 经 验 的 网 络 开发 者 更 有 可 能 从 事 移动 网 络 开发 。 开 发 者 可 以 通过 
HTML, CSS, JavaScript 等 技术 开发 网 络 应 用 ， 而 无 须 学 习 新 的 编程 语言 。 对 开发 者 来 说 ， 
本 地 应 用 开发 也 许 并 不 是 最 困难 的 事情 ， 但 网 络 开发 将 会 是 他 们 熟练 掌握 的 技术 。 移 动 网 
络 应 用 市 场 比 本 地 应 用 市 场 更 大 。 通 过 开发 网 络 应 用 ， 开 发 者 可 以 通过 单一 版 本 的 应 用 获 
得 广泛 的 用 户 群 (来 自 各 种 平台 的 手机 )。iPhone、Android 和 Windows Mobile 只 代表 了 一 小 
部 分 移动 市 场 ， 而 大 部 分 手机 都 可 以 访问 移动 网 络 。 

另外 ， 移 动 互联 网 是 一 个 开放 和 平台， 开发 者 无 须 等 待 长 达 数 周 的 审查 过 程 (结果 却 被 拒 
之 门 外 )。 乔 布 斯 无 法 像 审查 iPhone 应 用 那样 审查 网 络 应 用 ， 而 且 开 发 者 也 无 须 等 待 。 


本 书 的 内 容 
本 书 循序 渐进 地 讲解 了 开发 Android 网 络 应 用 的 基本 知识 ， 并 通过 具体 的 实例 讲解 了 
各 个 知识 点 的 具体 用 法 。 本 书 内 容 新 颖 、 知 识 全 面 、 讲 解 详细 ， 全 书 共 分 16 章 ， 有 具体 说 明 
如 下 。 
mq 主要 内 容 
第 1 章 | Android 系统 介绍 
第 2 章 | Android 网 络 开发 基础 


第 3 章 HTTP 通信 处 理 


前 言 
续 表 
章节 主要 内 容 

第 6 章 WebKit 浏览 器 详解 

第 7 章 在 Android 中 开发 蓝牙 应 用 

第 8 章 在 Android 中 开发 Wi-Fi 应 用 

第 9 章 在 Android 中 开发 RSS 应 用 

第 10 章 在 Android 中 开发 电子 邮件 应 用 

fa 让 网 络 和 多 媒体 接轨 

第 12 章 在 Android 中 开发 移动 微 博 应 用 

第 13 章 Android 流量 统计 系统 

第 14 章 开发 流量 监控 系统 

第 15 章 Android 网 络 典型 应 用 实践 

第 16 章 开发 一 个 邮件 系统 

科学 的 学 习 方法 

不 要 认为 学 习 计算 机 网 络 是 一 件 很 困难 的 事情 ， 不 断 寻 找 规律 ， 学 习 新 知识 和 新 技能 ， 
积累 经 验 ， 这 几乎 是 每 一 个 电脑 高 手 的 成 长 之 路 。 e “ 授 人 以 鱼 ， 不 如 授 人 


以 渔 。” 说 的 是 传授 给 人 既 有 知识 ， 不 如 传授 给 人 学 习 知 识 的 方法 。 通 过 本 书 ， 我 们 将 告 
诉 读者 学 习 的 方法 ， 并 介绍 一 条 比较 清晰 的 学 习 之 路 。 

1) 积极 的 心态 

无 论 是 知识 还 是 技能 ， 智者 之 所 以 能 够 更 好 更 快 地 掌握 这 些 知识 和 技能 ， 很 大 程度 上 
得 益 于 良好 的 学 习 方法 。 人 们 常 说 : 兴趣 是 最 好 的 老师 ， 压 力 是 前 进 的 动力 ， 要 想 获得 一 
个 积极 的 心态 ， 最 好 能 对 学 习 对 象 保持 浓厚 的 兴趣 。 如 果 暂 时 提 不 起 兴趣 ， 那 么 试 试 把 来 
自 工 作 或 生活 的 压力 ， 转 化 为 学 习 的 动力 。 


2) 注重 实践 


建议 读者 在 学 习 本 书 的 过 程 中 ， 学 完 理论 后 


再 动手 调试 本 书 中 的 实例 ， 然 后 用 模拟 器 运行 书 中 的 例子 。 只 
真正 理解 Android 网 络 的 基本 知识 。 


能 生 巧 、 触 类 旁 通 。 
3) 学 以 致 用 


对 于 计算 机 网 络 技术 ， 除 了 少 部 


这 样 当 在 实 


通过 网 络 解决 工作 中 的 问题 并 提高 工作 效率 。 


机 ， 
(1) 利 上 


网 络 资源 和 课外 资料 


， 进 行 实际 操作 。 首 先 学习 书 中 的 理论 ， 
有 这 样 才能 做 到 印象 深刻 ， 
际 应 用 中 直到 其 他 类 似 问 题 时 , 才能 做 到 熟 


分 专业 人 士 外 ， 大 部 分 人 学 习 网 络 的 目的 是 为 了 应 用 ， 


“解决 问题 ”常常 是 促使 人 们 学 习 的 一 大 动 


带 着 问题 学 习 ， 不 但 进步 快 ， 而 且 很 容易 对 网 络 产生 更 大 的 兴趣 ， 从 而 获得 持续 的 


在 学 习 过 程 中 ， 难 免 会 遇 到 自己 不 理解 的 知识 ， 此 时 可 以 找 一 些 相关 的 书籍 来 阅读 ， 


不 断 尝 试 解决 问题 。 或 者 通过 互联 网 的 搜索 引擎 找到 问题 的 解决 办 法 ， 善 用 搜索 引擎 ， 基 
本 上 可 以 找到 大 多 数 问题 的 所 在 ! 

(2) QQ fi 

如 果 在 互联 网 找 不 到 问题 的 解决 办 法 ， 可 以 通过 QQ 访问 相关 学 习 群 ， 群 中 的 网 络 高 
手 们 会 对 你 提出 的 问题 进行 回答 。 

(3) 向 网 络 高 手 学 习 


摸 象 ， 则 很 难 掌握 技术 精 散 。 而 经 过 身边 网 络 高 手 的 指点 ， 可 以 轻松 掌握 相关 的 技能 。 


本 书 的 特色 

本 书 内 容 相 当 丰 富 , JE ELE its ii, 可 以 满足 Android 网 络 开发 技术 人 员 成 长 道路 上 的 
方方面面 。 我 们 的 目标 是 通过 一 本 图 书 ， 提 供 多 本 图 书 的 价值 ， 读 者 可 以 根据 自己 的 需要 
有 选择 地 阅读 ， 以 完善 本 人 的 知识 和 技能 结构 。 在 内 容 的 编写 上 ， 本 书 具 有 以 下 特色 。 

1. 结构 合理 

从 用 户 的 实际 需要 出 发 ， 科 学 安排 知识 结构 ， 内 容 由 浅 入 深 ， 倒 述 清楚 ， 并 附 有 相应 
的 总 结 和 练习 , 具有 很 强 的 知识 性 和 实用 性 , 反映 了 当前 Android 网 络 开发 技术 的 发 展 和 应 
用 水 平 。 同 时 全 书 精 心 筛 选 了 最 具 代 表 性 、 读 者 最 关心 的 典型 知识 点 ， 这 些 知 识 点 几乎 包 
括 了 Android 网 络 开发 技术 的 所 有 方面 。 

2. 易学 易 懂 

本 书 条 理 清 晰 、 语 言 简 洁 ， 可 帮助 读者 快速 掌握 每 个 知识 点 ， 每 个 部 分 既 相互 连贯 又 
自 成 体系 ， 使 读者 既 可 以 按照 本 书 编排 的 章节 顺序 进行 学 习 ， 也 可 以 根据 自己 的 需求 对 某 
-章节 进行 针对 性 的 学 习 。 

3. 实用 性 强 

本 书 彻 底 据 弃 枯燥 的 理论 和 简单 的 操作 , 注重 实用 性 和 可 操作 性 , 将 Android 网 络 开发 
技术 的 理论 融合 到 实际 的 操作 环境 中 ， 使 用 户 在 掌握 相关 操作 技能 的 同时 ， 还 能 够 学 习 到 
相应 的 开发 知识 。 

4. 实例 典型 

书 中 的 开发 实例 不 仅 典型 而 且 具 有 创意 ， 将 传统 互联 网 的 内 容 / 服 务 与 移动 平台 紧密 结 
合 起 来 ， 体 现 了 移动 互联 网 应 用 所 需 的 创新 精神 及 良好 的 用 户 体验 理念 ， 这 个 设计 思路 非 
常 值得 大 家 去 思考 和 学 习 。 


本 书 的 读者 对 象 


本 书 在 内 容 安排 上 由 浅 入 深 ， 写 作 上 层 层 剥 洋葱 式 的 分 解 ， 实 例 充 分 举证 ， 非 常 适合 
于 入 门 Android 网 络 开发 技术 的 初学 者 ， 同 时 也 适合 于 具有 一 定 Android 开发 基础 ， 想 对 


BE 


Android 网 络 开发 技术 进一步 了 解 和 掌握 的 中 级 学 者 。 如 果 你 是 以 下 类 型 的 学 者 ， 此 书 会 带 
领 你 迅速 进入 Android 开发 领域 。 


口 
口 
z 
口 
口 


口 
m] 


有 一 定 Android 开发 经 验 的 读者 。 

从 事 Android 开发 的 研究 人 员 和 工作 人 员 。 

有 一 定 的 Android 基础 ， 想 快速 学 会 Android 高 级 技术 的 读者 。 

有 一 定 Android 开发 基础 ， 需 要 加 深 对 Android 技术 核心 进一步 了 解 和 掌握 的 程 
序 员 。 

高 等 院 校 相关 专业 的 学 生 ， 或 需要 编写 论文 的 学 生 。 

企业 和 公司 在 职 人 员 、 需 要 提高 学 习 或 工作 需要 的 程序 员 。 

从 事 Android 移动 网 络 开 发 等 相关 工作 的 技术 人 员 。 


在 本 书 的 写作 过 程 中 得 到 了 清华 大 学 出 版 社工 作 人 员 的 大 力 支持 ， 在 此 特意 感谢 各 位 
编辑 老师 们 的 指点 和 付出 的 汗水 。 另 外 ， 笔 者 本 人 毕竟 水 平 有 限 ， 如 有 丝 漏 和 不 尽 如 入 意 
之 处 在 所 难免 ， 诚 请 读者 提出 意见 或 建议 ， 以 便 修订 并 使 之 更 至 完善 。 


本 书 部 分 源 代码 网 络 下 载 路 径 : http://www.tup.tsinghua.edu.cn。 
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Androi0 系 统 介绍 


Android 是 2007 年 推出 的 一 款 智能 手机 平台 ， 它 是 建立 在 
Linux 的 开源 基础 之 上 的 ， 能 够 迅速 建立 手机 软件 的 解决 方 
案 。 虽 然 Android 的 外 形 比 较 简 单 ， 但 是 其 功能 却 十 分 强大 ， 
已 经 成 为 一 个 新 兴 的 热点 ， 并 且 成 为 市 场 占有 率 排 名 第 一 的 智 
能 手机 操作 系统 。 本 章 将 简单 介绍 Android 系统 的 相关 知识 ， 
让 读者 了 解 Android 的 发 展 之 路 。 
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1.4 Android 是 一 款 智 能 手机 


其 实在 Android 系统 诞生 之 前 ， 智 能 手机 就 已 经 大 大 丰富 了 人 们 的 生活 ， 受 到 广大 手 
机 用 户 的 追捧 。 各 大 手机 厂商 在 利益 的 驱动 之 下 ， 纷 纷 建立 了 自己 的 智能 手机 操作 系统 来 
抢夺 市 场 份额 。Android 系统 就 是 在 这 个 风起云涌 的 历史 背景 下 诞生 的 。 


1.1.1 什么 是 智能 手机 


智能 手机 是 指 具 有 像 个 人 电脑 那样 强大 的 功能 ， 拥 有 独立 的 操作 系统 ， 用 户 可 以 自行 
安装 游戏 等 第 三 方 服务 商 提供 的 程序 ， 并 且 可 以 通过 移动 通信 网 络 来 接 入 无 线 网 络 。 在 
Android 系统 诞生 之 前 ， 市 面 上 已 经 有 多 款 智 能 手机 产品 ， 例 如 Symbian 和 微软 的 
Windows Mobile 系列 等 。 

一 般 来 说 ， 智 能 手机 必须 具备 下 面 几 个 标准 功能 。 

(1) 操作 系统 必须 支持 新 应 用 的 安装 。 

(2) 高 速度 处 理 芯 片 。 

(3) 支持 播放 式 的 手机 电视 。 

(4) 大 存储 芯片 和 存储 扩展 能 力 。 

(5) 支持 GPS 导航 。 

根据 上 述 标准 ， 手 机 联盟 公布 了 智能 手机 的 主要 特点 。 

(1) 应 具备 普通 手机 的 所 有 功能 。 例 如 ， 可 以 进行 正常 的 通话 和 收发 短信 等 基本 的 手 
机 应 用 。 

Q) 是 一 个 开放 性 的 操作 系统 ， 在 系统 上 可 以 安装 更 多 的 应 用 程序 ， 从 而 实现 功能 的 
无 限 扩充 。 

(3) 具备 上 网 功能 。 

(4) 具备 PDA 的 功能 ， 能 够 实现 个 人 信息 管理 、 日 程 记事 、 任 务 安排 、 多 媒体 应 用 、 
浏览 网 页 等 功能 。 

(5) 可 以 根据 个 人 需要 扩展 机 器 的 功能 。 

(6) 扩展 性 能 强 ， 并 且 可 以 支持 众多 第 三 方 软件 。 


1.1.2 ”当前 主流 的 智能 手机 系统 

目前 市 面 上 最 主流 的 智能 手机 系统 当 属 Windows Mobile、 塞 班 Symbian, Palm, XU 
BlackBerry、 苹 果 iOS 和 本 书 的 主角 Android. 

1. 微软 的 Windows Mobile 


Windows Mobile 是 微软 公司 的 一 款 杰出 产品 ， 它 将 熟悉 的 Windows 桌面 扩展 到 了 个 
人 设备 中 。 使 用 Windows Mobile 操作 系统 的 设备 主要 有 PPC 手机 、PDA、 随 身 音乐 播放 
器 等 。Windows Mobile 操作 系统 有 三 种 ， 分 别 是 Windows Mobile Standard. Windows 
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Mobile Professional 和 Windows Mobile Classic。 


2. 塞 班 Symbian 


Symbian 系统 出 自由 诺基亚 、 索 尼 爱 立信 、 摩 托 罗拉 、 西 门 子 等 几 家 大 型 移动 通信 设 

备 商 共同 出 资 组 建 的 一 个 合资 公司 ， 专 门 研发 手机 操作 系统 。 现 已 被 诺基亚 全 额 收 购 。 

Symbian 有 着 良好 的 界面 ， 采 用 内 核 与 界面 分 离 技术 ， 对 硬件 的 要 求 比较 低 ， 支 持 C++、 

Visual Basic 和 J2ME。 目 前 根据 人 机 界面 的 不 同 ，Symbian 体系 的 UI(User Interface， 用 户 

界面 ) 平 台 分 为 Series60、Series80、Series90、UIQ 等 。 其 中 ，Series60 主要 是 给 数字 键盘 

手机 用 ; Series80 是 为 完整 键盘 所 设计 ;Series90 则 是 为 触 控 笔 方式 而 设计 。 

SAGER: © 2010 年 9 月 ， 诺基亚 宣布 将 从 2011 年 4 月 起 从 Symbian 基金 会 (Symbian 
Foundation) 手 中 收回 Symbian 操作 系统 控制 权 。 由 此 看 来 ， 诺 基 亚 在 2008 
年 全 资 收购 塞 班 公司 之 后 希望 继续 扩大 塞 班 影响 力 的 愿望 并 没有 实现 。 
Q 在 苹果 和 Android 的 强大 市 场 攻势 下 ， 诺 基 亚 在 2011 年 2 月 11 日 宣布 与 
微软 达成 广泛 战略 合作 关系 ， 并 将 Windows Phone 作为 其 主要 的 智能 手机 操 
作 系统 。 这 家 芬兰 手机 巨头 试图 通过 结盟 捏 转身 势 。 规 止 本 书 成 稿 时 ， 诺 基 
亚 和 微软 联合 推出 了 最 新 版 本 Windows Phone 8. 
© 2011 年 8 月 15 日 ， 谷 歌 和 摩托 罗拉 移动 公司 共同 宣布 ， 谷 歌 将 以 每 股 
40.00 美元 现金 收购 摩托 罗拉 移动 ， 总 额 约 125 亿美 元 ， 相 比 摩托 罗拉 移动 
股份 的 收盘 价 溢价 了 63%， 双 方 董事 会 都 已 全 票 通过 该 交易 。 谷 歌 CEO d 
里 。 佩 奇 表示 ， 摩 托 罗 拉 移 动 将 完全 专注 于 Android 系统 ， 收 购 摩托 罗拉 移 
动 之 后 ， 将 增强 整个 Android 生态 系统 。 佩 奇 同时 表示 ，Android 将 继续 开 
源 ， 收 购 的 一 个 目的 是 为 了 获得 专利 。 


3. Palm 

Palm 是 流行 的 个 人 数字 助理 (PDA， 又 称 掌 上 电脑 ) 的 传统 名 字 。 从 广义 上 讲 ，Palm 是 
PDA 的 一 种 ， 是 Palm 公司 发 明 的 。 而 从 狭义 上 讲 ，Palm 是 Palm 公司 生产 的 PDA 产品 ， 
区 别 于 Sony 公司 的 Clie 和 Handspring 公司 的 Visor/Treo 等 其 他 运行 Palm 操作 系统 的 
PDA 产品 。 其 显著 特点 之 一 是 写 入 装置 输入 数据 的 方法 ， 能 够 点 击 显 示 器 上 的 图 标 选择 输 
入 的 项 目 。2009 年 2 月 11 H, Palm 公司 CEO Ed Colligan 宣布 以 后 将 专注 于 WebOS 和 
Windows Mobile 的 智能 设备 ， 而 将 不 会 再 有 基于 “Palm OS” 的 智能 设备 推出 ， 除 了 Palm 
Centro 会 在 以 后 和 其 他 运营 商 合作 时 继续 推出 。 


4. 8 BlackBerry 

BlackBerry 是 加 拿 大 RIM 公司 推出 的 一 种 移动 电子 邮件 系统 终端 ， 其 特色 是 支持 推动 
式 电子 邮件 、 手 机 、 文 字 短 信 、 互 联网 传真 、 网 页 浏览 及 其 他 无 线 资讯 服务 ， 其 最 大 优势 
是 收发 邮件 。 正 因为 这 一 优势 ， 所 以 受到 了 商务 用 户 的 格外 青睐 。 

5.iOS 

iOS 作为 苹果 移动 设备 iPhone 和 iPad 的 操作 系统 ， 在 App Store 的 推动 之 下 ， 成 为 世 
界 上 引领 潮流 的 操作 系统 之 一 。 原 本 这 个 系统 名 为 “iPhone OS”， 直 到 2010 年 6 月 7 日 
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WWDC 大 会 上 宣布 改名 为 “i0OS”。iOS 推出 的 理念 是 能 够 使 用 多 点 触 控 屏 幕 的 方式 来 操 
控 手 机 。 控 制 方法 包括 滑动 、 轻 触 开 关 及 按键 。 与 系统 交互 包括 滑动 (Swiping)、 轻 按 
(Tapping)、 挤 压 (Pinching， 通 常用 于 缩小 ) 及 反 向 挤 压 (Reverse Pinching or unpinching， 通 常 
用 于 放大 )。 此 外 通过 其 自 带 的 加 速 器 ， 可 以 令 其 旋转 设备 改变 其 y 轴 以 使 屏幕 改变 方向 ， 
这 样 的 设计 令 iPhone 更 便于 使 用 。 

从 最 初 的 iPhone OS 演变 至 最 新 的 iOS 系统 ， 它 横 跨 iPod Touch, iPad, iPhone, pk 
苹果 最 强大 的 操作 系统 ， 甚 至 新 一 代 的 Mac OS X Lion 也 借鉴 了 iOS 系统 的 一 些 设计 。 可 
以 说 10S 是 苹果 的 又 一 个 成 功 的 操作 系统 ， 能 给 用 户 带 来 极 佳 的 使 用 体验 。 

6. Android 

Android 是 我 们 本 书 的 主角 ， 是 谷歌 于 2007 年 11 月 5 日 宣布 的 基于 Linux 平台 的 开 
源 手机 操作 系统 的 名 称 。Android 平台 由 操作 系统 、 中 间 件 、 用 户 界面 和 应 用 软件 组 成 ， 
号 称 是 首 个 为 移动 终端 打造 的 真正 开放 和 完整 的 移动 软件 。 


1.2 Android 的 巨大 优势 


从 2007 年 11 月 5 日 诞生 之 日 起 ， 到 2011 年 7 A, Android 系统 在 智能 手机 的 占有 率 
高 达 43%， 位 居 智能 手机 系统 占有 率 排行 榜 的 第 一 位 。 并 且 随 着 各 大 厂商 新 产品 的 推出 ， 
必然 会 继续 巩固 这 一 地 位 。 为 什么 Android 能 在 这 么 多 的 智能 系统 中 脱颖而出 ， 成 为 市 场 
占有 率 第 一 的 手机 系统 呢 ? 要 想 分 析 其 原因 ， 需 要 先 了 解 它 的 巨大 优势 ， 分 析 究 竟 是 哪些 
优点 吸引 了 厂商 和 消费 者 的 青睐 。 

1. 系 出 名 门 

Android 出 身 于 Linux 家 族 ， 是 一 款 号 称 开源 的 手机 操作 系统 。 当 Android“ 一 炮 走 
红 ” 之 后 ， 各 大 手机 联盟 纷纷 加 入 ， 并 且 都 推出 了 各 自 系 列 产品 。 这 个 联盟 由 包括 中 国 移 
动 、 三 星 、 摩 托 罗 拉 、 高 通 、 宏 达 电子 和 T-Mobile 等 在 内 的 30 多 家 技术 和 无 线 应 用 的 领 
军 企业 组 成 。 通 过 与 运营 商 、 设 备 制造 商 、 开 发 商 和 其 他 有 关 各 方 结 成 深层 次 的 合作 伙伴 
关系 ， 希 望 借助 建立 标准 化 、 开 放 式 的 移动 电话 软件 平台 ， 在 移动 产业 内 形成 一 个 开放 式 
的 生态 系统 。 


2. 开发 团队 的 支持 

Android 的 研发 队伍 阵容 豪华 ， 包 括 摩托 罗拉 、Google、HTC( 宏 达 电 子 )、Philips、T- 
Mobile、 高 通 、 魅 族 、 三 星 、LG 以 及 中 国 移动 在 内 的 34 家 企业 ， 他 们 都 将 基于 该 平台 开 
发 手机 的 新 型 业务 ， 应 用 之 间 的 通用 性 和 互联 性 将 在 最 大 程度 上 得 到 保持 。 

3. 诱 人 的 奖励 机 制 

谷歌 为 了 提高 程序 员 的 开发 积极 性 ， 不 但 为 他 们 提供 了 一 流 的 硬件 设置 和 软件 服务 ， 
而 且 还 采取 了 振奋 人 心 的 奖励 机 制 ， 定 期 举行 比赛 ， 创 意 和 应 用 夺魁 者 将 会 得 到 重奖 。 


4. 开源 
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开源 意味 着 对 开发 人 员 和 手机 厂商 来 说 ，Android 是 完全 无 偿 免 费 使 用 的 。 因 为 源 代 
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因 ， 所 以 激发 了 全 世界 各 地 无 数 程序 员 的 热情 。 于 是 很 多 手机 厂商 纷纷 采用 


Android 作为 自己 产品 的 系统 ， 甚 至 包括 很 多 山寨 厂商 。 而 对 于 开发 人 员 来 说 ， 众 多 厂商 
的 采用 就 意味 着 人 才 需 求 大 ， 所 以 纷纷 加 入 到 Android 开发 大 军 中 来 。 于 是 有 一 些 干 的 还 
可 以 的 程序 员 经 不 住 高 薪 诱 惑 ， 都 纷纷 改行 做 Android 开发 。 至 于 “ 混 ” 得 不 尽 如 人 意 的 
程序 员 ， 就 更 加 坚定 了 “改行 做 Android 手机 开发 ”， 目 的 是 想 寻找 自己 程序 员 生 涯 的 转 
机 。 并 且 有 很 多 遇 到 发 展 瓶颈 的 程序 员 ， 也 决定 做 Android 开发 ， 因 为 这 样 可 以 学 习 一 门 
新 技术 ， 使 自己 的 未 来 更 加 有 保障 。 


1.3 搭建 Android 开发 环境 


“ 工 欲 善 其 事 ， 必 先 利 其 器 ”出 自 《 论 语 》， 意 思 是 要 想 高 效 地 完成 一 件 事 ， 需 要 

有 一 个 合适 的 工具 。 对 于 Android 开发 人 员 来 说 ， 开 发 工具 同样 至 关 重要 。 作 为 一 项 新 兴 

技术 ， 在 进行 开发 前 首先 要 搭建 一 个 对 应 的 开发 环境 。 而 在 搭建 开发 环境 前 ， 需 要 了 解 安 
装 开发 工具 所 需要 的 硬件 和 软件 配置 条 件 。 

在 具体 搭建 Android 开发 环境 之 前 ， 首 先 需要 明确 Android 开发 包括 底层 开发 和 应 用 


开发 两 部 分 。 
a “底层 开发 : 大 多 数 是 指 和 硬件 相关 的 开发 ， 并 且 是 基于 Linux 环境 的 ， 例 如 开发 
驱动 程序 。 


口 ” 应 用 开发 : 是 指 开发 能 在 Android 系统 上 运行 的 程序 ， 例 如 游戏 、 地 图 等 程序 。 
本 书 的 重点 是 讲解 多 媒体 应 用 开发 ， 即 使 讲 一 些 底层 的 知识 ， 也 是 为 上 层 的 应 用 
服务 的 。 
另外 ， 因 为 目前 市 面 上 最 主流 的 操作 系统 是 Windows， 所 以 本 书 只 介绍 在 Windows 环 
境 下 搭建 Android 开发 环境 的 过 程 。 


1.3.1 安装 Android 系 统 的 要 求 


在 搭建 开发 环境 之 前 ， 一 定 先 确定 基于 Android 应 用 软件 所 需要 开发 环境 的 要 求 ， 具 
体 如 表 1-1 所 示 。 


X A 


表 1-1 开发 系统 要 求 


操作 系统 


软件 
开发 包 


HAER 说 明 & x 
Windows XP/Windows 7 | 根据 自己 的 电脑 自行 选择 | 选择 自己 最 熟悉 的 操作 系统 
/Windows 8 


截止 到 目前 ， 最 新 手机 版 本 
i 选择 :的 SDK 


» Andicid ssish^nsma 


续 表 
版 本 要 求 说 BA 备 注 


Eclipse 3.3 以 上 版 本 和 ADT(Android 
Eclipse IDE+ADT à 选择 for Java Developer 


Development Tools) 开 发 插件 


JDK Apache Ant J SE Devel tKit5 或 6 不 能 选择 单独 的 IRE 进行 安 
lache t lava ‘velopment! n! y^ 
P 装 ， 必 须要 有 IDK 


Android 开发 工具 是 由 多 个 开发 包 组 成 的 ， 其 中 最 主要 的 开发 包 如 下 。 

Q JDK: 可 以 到 网 址 http://www.oracle.com/technetwork/java/javase/downloads/ 
index.html 下 载 。 

Q Eclipse: 可 以 到 网 址 http://www.eclipse.org/downloads/ F 4% Eclipse IDE for Java 
Developers。 

口 Android SDK: 可 以 到 网 址 http://developer.android.com 下 载 。 

口 下 载 对 应 的 开发 插件 。 


1.3.2 ”安装 Android 插 件 


本 书 的 安装 是 以 Windows 7 为 平台 ， 安 装 的 软件 为 DK 1.6. Eclipse 3.3. ADT 1.5, 
Android SDK 2.3。 下 面具 体 介绍 各 自 的 安装 步骤 ， 并 且 在 配套 的 视频 中 有 详细 的 介绍 。 
1. 安装 JDK 


安装 Eclipse 的 开发 环境 需要 IRE 的 支持 ， 在 Windows 上 安装 JRE/IDK 非常 简单 ， 
流程 如 下 。 

(1) 在 Sun 官方 网 站 下 载 ， 网 址 为 http://www.oracle.com/technetwork/java/javase/downloads/ 
index.html， 如 图 1-1 所 示 。 

(2) 在 图 1-1 中 可 以 看 到 有 很 多 版 本 ， 运 行 Eclipse 时 虽然 只 需要 IRE 就 可 以 了 ， 但 是 
在 开发 Android 应 用 程序 的 时 候 ， 却 需要 完整 的 JDK(JDK 已 经 包含 了 JRE)， 并 且 要 求 其 
版 本 在 1.5 以 上 ， 这 里 选择 Java SE (IDK) 6。 其 下 载 页 面 如 图 1-2 所 示 。 

(3) 在 图 1-2 中 找到 “JDK 6 Update 22” 项 目 ， 单 击 其 右 侧 的 Download 按钮 后 弹出 填 
写 登 录 信 息 界 面 ， 在 此 输入 你 的 账号 信息 ， 如 果 没 有 账号 可 以 免费 注册 一 个 。 然 后 单 击 
Continue 按钮 ， 如 图 1-3 所 示 。 

(4) 进入 “选择 操作 系统 和 语言 ”界面 ， 在 此 首先 选择 Windows 选项 ， 然 后 单 击 
Download 按钮 ， 如 图 1-4 所 示 。 

(5) 下 载 安装 文件 jdk-6u22-windows-i586.exe。 

(6) 下 载 完成 后 双击 jdk-6u22-windows-i586.exe 开始 安装 ， 将 弹出 安装 向 导 对 话 框 。 
然后 单 击 “ 下 一 步 ” 按 钮 ， 如 图 1-5 所 示 。 

(7) 弹出 “ 自 定义 安装 ”界面 ， 在 其 中 选择 文件 的 安装 路 径 ， 如 图 1-6 所 示 。 

(8) 单 击 “ 下 一 步 ” 按 钮 ， 开 始 安装 ， 如 图 1-7 所 示 。 


Et D 
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Java DB « « « 

Web Ter Æ java | =Æ jJavaFX |% NetBeans = Java 
Java Card Java EE | 
New to Java Java Platform (JDK) 7u5 JavaFX 2.1.1 JDK 7u5 + NetBeans. JDK 7u3 * Java EE 
Community 


Java Magazine Here are the Java SE downloads in detail: 


Java Advanced 
Java Platform, Standard Edition 
Java SE 7u5 JDK JRE 
This release includes security enhancements 
and bug fixes. Learn more » 
"What Java Do Need?” You musthave a copyof  JDK7 Docs JRE7 Docs 
the JRE (Java Runtime Environment) on your iain P : 
system to run Java applications and applets. To ei re 
develop Java applications and applets, you need 
the JDK (Java Development Kit), which includes | * ReadMe * ReadMe 
the JRE 
* ReleaseNotes * ReleaseNotes 
* Java SE * Java SE 
Products Products 
* Third P; * Third Party 
Licenses Licenses 


JDK 7 Demos and Samples 

Demos and samples of common tasks and new 
functionality available on JDK 7. The source code 
provided with samples and demos for the JDK is 
meantto illustrate the usage of a given feature or 


图 1-1 Sun 官 方 下 载 页 面 


DK 6 Update 22 (JDK or JRE) 
his release includes performance improvements and 
security vulnerability fixes. Learn more » 


iat Java Do | Need? You must have a copy of the JRE 
(Java Runtime Environment) on your system to run Java 
lapplications and applets. To develop Java applications 
land applets, you need the JDK (Java Development Kit), 
hich includes the JRE. 


Installation 
Instructions 


ReadMe 


ReleaseNotes 


Oracle License 


Third Party 
Licenses 


Supported System 


Certified System * Certified System 
Configurations Configurations 


JDK Demos and Samples 


Installation 
Instructions 


ReadMe 
ReleaseNotes 


Oracle License 


Third Party 
Licenses 


Supported System 


Configurations 


1-2 JDKFZE 


Configurations 
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There is more information on the available files for download on the Supported 


System Configurations page. 


Select Platform and Language for your download: 


Platform: [Windows = 


Language: Multi-language 


By selecting ‘Continue’ below, you hereby accept the terms and conditions ofthe Java SE 
Development Kit 6u22 License Agreement 


Optional: Please Log In or Register for additional functionality and benefits 
Or, click"Continue" now to proceed without Log In or Registration. 


[guanxjing@126.com 


Example: jim23 or jim@company.com 


Password: 
» Register Now 


User Name: 


Continue » 


图 1-3 输入 账号 信息 


JDK 6 Update 17 
Download Java SE Development Kit 6u17 This special release provides a few key fixes. 
Platform: FAO 
Windows Instatation instructions 
Language: uae 
Mat anus ReleaseNotes 
Sun License 


By selecting Download or 'Conthue! below, you 
hereby accept the terms end condtion of the v= 


Third Party Licenses 
T Supported System Configurations 


T Use Sun Download Manager (Lean More) 


Your download will begin shortly, please 
wait. 


Click here it your download dd rol start 
automaticaly 


图 1-4 选择 Windows 选 项 


欢迎 使 用 Java(TM) SE Development Kit 6 Update 22 安装 向 导 


BLESS | SHE TERI, Java SE Development Kit 6 Update 22 的 安装 过 程 。 
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图 1-6 “ 自 定义 安装 ”界面 图 1-7 开始 安装 
(9) 弹出 “目标 文件 夹 ”界面 ， 在 其 中 选择 要 安装 的 位 置 ， 如 图 1-8 所 示 。 


1-8 “目标 文件 夹 ” 界面 
(10) 单 击 “ 下 一 步 ”按钮 后 继续 安装 ， 如 图 1-9 所 示 。 


B B BH OH B B gaien 


1-9 ”继续 安装 
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(11) 弹出 已 成 功 安装 界面 ， 单 击 “ 完 成 ”按钮 完成 整个 安装 过 程 ， 如 图 1-10 所 示 。 


Java(TM) SE Development Kit 6 Update 22 已 成 功 安装 


产品 注册 是 免费 的 ， 您 将 获得 加 下 增值 服务 : 

* 获得 新 版 本 、 修 补 程序 和 更 新 的 通知 服务 

* 获得 有 关 Sun 开发 者 产品 、 服 务 和 培训 的 忧 惠 
* 获得 对 早期 版 本 和 文档 的 访问 权限 


当 悠 单 击 * 完 成 "后 格 收集 产品 与 系统 信息 ， 同 时 显示 ]DK 产品 注册 表单 。 如 果 您 
不 注册 ， 则 不 保存 以 上 信息 。 


Tope 人 及 这 些 数据 的 管理 和 使 用 方式 的 更 多 信息 ， 请 参见 产品 
注册 信息 页 1 


产品 注册 信息 (P) 
[— ERE | 
图 1-10 “完成 安装 
T 注意 ; ”完成 安装 后 可 以 检测 是 否 安装 成 功 ， 方 法 是 : 依次 选择 “开始 ”| “运行 ” 
命令 ， 在 “运行 ”对 话 框 中 输入 “cmd” 并 按 Enter 键 ， 在 打开 的 CMD 窗口 中 
输入 “java-version”， 如 果 显 示 如 图 1-11 所 示 的 提示 信息 ， 则 说 明 安装 成 功 。 


ttings dninistrator>java -version 


Runtime Environment (build 1.6.8 22-b845 
tIM> Client UM (build 17.1-b@3, mixed mode, sharing? 


:NDocunents and Settings Administrator> 


1-11 CMD 窗 口 


如 果 检 测 到 没有 安装 成 功 ， 则 需要 将 其 目录 的 绝对 路 径 添 加 到 系统 的 PATH rp. Hu 
做 法 如 下 。 

(1) 右 击 “我 的 电脑 ”， 依 次 选择 “属性 ”|“ 高 级 ”命令 ， 再 单 击 “环境 变量 ”， 然 
后 在 “系统 变量 ”处 选择 新 建 、 在 “变量 名 ” 入 “JAVA HOME”、 在 “ "m i” Fp 
输入 刚才 的 目录 ， 比 如 笔者 的 目录 是 : C:\Program Files Java jdk1.6.0 22， 如 图 1-12 所 示 。 
(2) 再 次 新 建 一 个 变量 名 classpath， 其 变量 值 如 下 
-7%JAVA_HOME%/1lib/rt.jar;%JAVA_HOME%/lib/tools.jar 

单 击 “确定 ”按钮 找到 PATH 的 变量 ， 双 击 或 单 击 编辑 ， 在 变量 值 最 前 面 添加 如 下 值 : 


$JAVA HOME$/bin; 


具体 如 图 1-13 所 示 。 

(3) 依次 选择 “开始 ”| “和 运行 ”命令 ， 在 “运行 ”对 话 框 中 输入 “cmd” 并 按 Enter 
键 ， 在 打开 的 CMD 窗口 中 输入 “java-version”， 如 果 显 示 如 图 1-14 所 示 的 提示 信息 ， 则 
说 明 安 装 成 功 。 
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XE [AVA YOME REED classpath 
RRAV: fF:\Java\ jak. 6.0 22 变量 值 四) ib/rt. jar: XJAVA HDMEX/ib/tools. jar 


[wx ] | Dow] x» | 


图 1-12 新建 变量 “JAVA_HOME” 图 1-13 新建 变量 “classpath” 


901 
t Corp 


dninistrator>jav 


haring) 


:Documents and Settings Administrator. 


图 1-14 CMRE 
WER: ”上 述 变 量 是 按照 笔者 本 人 的 安装 路 径 设置 的 ， 笔 者 安装 IDK 的 路 径 是 
C:\Program Files\Java\jdk1.6.0_22. 
2. 安装 Eclipse 
在 安装 好 JDK 后 ， 就 可 以 开始 安装 Eclipse 了 ， 具 体 安装 步骤 如 下 。 
(1) 打开 Eclipse 的 官方 下 载 页 面 http://www.eclipse.org/downloads/， 如 图 1-15 所 示 。 
Home Downloads Users Members Committers Resources Projects About Us Search 


Eclipse Downloads 


| Eclipse Packages | Project 


Galileo Packages (based ipse Compare Packages 


(a. Exlipse IDE for Java EE Developers (189 MB) 
Tools for Java developers creating Java EE and Web applications, including a Java IDE, 
JEE| tools for Java EE, JPA, JSF, Mylyn and others, More, 


Downloads: 1,195,339 Linux 320m G4bR 


Eclipse IDE tor Java Developers (92 MB) Windows 
eS The essential tools for any Java developer, including a Java IDE, a CVS client, XML Editor 

and Myyn. More. 

Downloads: 601,023 


Eclipse for PHP Developers (199 MB) 
GD Tos for PHP developers creating Web applications, including PHP Development Tools 
po PON, Web Tools Platform, MYyn and others, More. 

Downloads: 287,974 Linux 32bit 64bit 


图 1-15 下 载 页 面 
(2) 在 图 1-15 5 lu Eclipse IDE for Java Developers (92 MB) 选 项 ， 进 入 其 
下 载 的 镜像 页 面 ， 在 此 只 需 选 择 离 用 户 最 近 的 镜像 即 可 (一 般 推 荐 的 下 载 速度 就 可 以 )， 如 
图 1-16 所 示 。 
G) 下 载 完 成 后 ， 先 找到 下 载 的 压缩 包 eclipse-java-galileo-SR1-win32.zip。 
AK 注意 : ”解压 下 载 的 Eclipse 压缩 文件 后 就 可 以 使 用 ， 而 无 须 执行 安装 程序 ， 不 过 在 


使 用 前 一 定 要 先 安 装 JDK。 在 此 假设 Eclipse 解压 后 存放 的 目录 为 
F:\eclipse. 
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Home Dewnlosds 


Users Members Committers Resources Projects AboutUs Search 


Eclipse downloads - mirror selection 
Downloads Home 


Pe All downloads are provided underthe terms and corditions of the Eclipse Foundation 
Bi Torrents. Software User Agreement unless otherwise specifed. 


© By project 


Download eclipse-jave-galileo-SRT-win32 zip from: 


china Amazon AWS itp) 
* @ BnTonent is available for this i 


lor pick a mirror site below. 
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(4) 进入 解压 后 的 目录 ， 此 时 可 以 看 到 一 个 名 为 “eclipse.exe” 的 可 执行 文件 ， 双 击 此 
文件 直接 运行 ，Eclipse 能 自动 找到 用 户 先前 安装 的 JDK 路 径 。 启 动 界面 如 图 1-17 所 示 。 


~ à 
eclipse 


GALILEO 


图 1-17 ”Eclipse 启动 界面 
因为 是 安装 后 第 一 次 启动 Eclipse， 所 以 会 看 到 选择 工作 空间 的 提示 ， 如 图 1-18 所 示 。 


Select a workspace 


Eclipse stores your projects in a folder called a workspace 
Choose & workspace folder to use for this session 


Workspace: [F:\eclipse\workspacel =] _ Browse. 


[7 Use this ax the default and do not ask again 


图 1-18 选择 工作 空间 
此 时 单 击 OK 按钮 ， 完 成 Eclipse 的 安装 。 
3. 安装 Android SDK 


完成 JDK 和 Eclipse 的 安装 后 ， 接 下 来 需要 下 载 安 装 Android SDK， 具 体 步骤 如 下 。 
(1) 打开 Android 开发 者 社区 网 址 http://developer.android.com/， 然 后 转 到 SDK 下 载 页 
面 (网 址 是 http://developer.android.com/sdk/index.html)， 如 图 1-19 所 示 。 


OB$ 1$ Android 系统 介绍 三 
= 
Developer Tools o ———— MENS Get the Android SDK 
Download ^ 
A The Android SDK provides you the API libraries and 
Installingthe — Li developer tools necessary to build, test, and debug 
SDK appsfor Android 
ExploringtheSDK 
NDK Download the SDK for Windows 
Workflow 
Other platforms | System requirements. 
Tools Help 
Revisions 
Extras 
Platform Package E | MDS Checksum 
Samples Windows android-sdk r20-windows zip 90353014 b62b0f80f559c0ac670e9f058a21f0df 
ADK me 
installer. r20-windows.exe 70497095 0f25321554e2f88b247320d6a3bcla7a 
(Recommended) bytes 
MacOSX android-sdk r20-macosx zip 58203018 b6b6035ccec55ec22a057438eb1db114 
(intel) bytes 
Linux(i386) ^ android-sdk /20-linux tgz 82589455 22a81cf1d4a951c62f71a8758290e9bb 
bytes 


图 1-19 SDK 下 载 页面 


(2) 在 此 选择 用 于 Windows 平台 的 链接 android-sdk_r20-windows.zip， 弹 出 如 图 1-20 
所 示 的 对 话 框 。 


正在 打开 android-sdk M rip 


您 已 选择 打开 
RB aaareid-sak_r20-vindows rip 
为 : WinRAR ZIP 压缩 文件 (6.2 MB) 
IB: http://dl. google. com 


您 想 要 Firefox 如 何 处 理 此 文件 3 一 一 一 一 一 一 一 一 一 一 一 一 一 


C 打开 方式 @) [WinRAR ZIP RU 
他 [保存 文件 G@) 1 
T^ 以 后 自动 采用 相同 的 动作 处 理 此 类 文件 。 (QU 


—- | 
图 1-20 Android SDK 下 载 页 面 


G) 下 载 后 解压 压缩 文件 ， 假 设 下 载 后 的 文件 解压 存放 在 F:\android\ 目 录 下 ， 并 将 其 
tools 目录 的 绝对 路 径 添加 到 系统 的 PATH 中 ， 具 体操 作 步 又 如 下 。 

O 右 击 “ 我 的 电脑 ”图 标 ， 选 择 “ 属 性 ”| “高 级 ”命令 ， 然 后 单 击 “ 环 境 变 
量 ”， 在 “系统 变量 ”处 选择 新 建 ， 在 “变量 名 ”处 输入 “SDK HOME ”， 在 “变量 
t” 中 输入 刚才 的 目录 ， 比如 笔者 的 目录 是 Fi\android-sdk-windows， 如 图 1-21 所 示 。 

© 找到 PATH 的 变量 ， 双 击 或 单 击 编辑 ， 在 “变量 值 ” 最 前 面 加 上 
“%SDK HOME%vtools:”， 如 图 1-22 dy 

@ 依次 选择 “开始 ”| “运行 ”命令 ， 在 “运行 ”对 话 框 中 输入 “cmd” 并 按 Enter 
键 ， 在 打开 的 CMD 窗口 中 输入 一 个 测 ir. 例如 ， 输 入 “android -h”， 如 果 显 示 如 
图 1-23 所 示 的 提示 信息 ， 则 说 明 安装 成 功 。 
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编辑 系统 变量 [eix] 编辑 系统 变量 HE 
变量 名 W [SDK. Home| 变量 名 名 path 
EIU JF: Vendroid-sdk windows ZEV [KSDK. HOMEX tools; XTAVA_HOMEX/ bin: C:" 
[as] mw meo] mm 
121 设置 系统 变量 图 1-22 设置 系统 变量 


id -h 


options] action [action options] 


the folders of 


图 1-23 设置 系统 变量 
4. 安装 ADT 
Android 为 Eclipse 定制 了 一 个 专用 插件 Android Development Tools(ADT)， 此 插件 为 
用 户 提 供 了 一 个 开发 Android 应 用 程 宗 合 环 境 。ADT 扩展 了 Eclipse 的 功能 ， 可 以 让 
用 户 快 速 地 建立 Android 项 目 ， 创 建 应 用 程序 界面 。 要 安装 Android Development Tools 
plug-in， 需 要 首先 打开 Eclipse IDE， 然 后 进行 如 下 操作 。 
(1) 打开 Eclipse 后 ， 依 次 选择 菜单 栏 中 的 Help | Install New Software 命令 ， 如 图 1-24 


所 示 。 


Help 
ce) Welcome 
(2) Help Contents 
Uy Search 
Dynamic Help 
Key Assist Ctrl+Shi fL 
Tips and Tricks. 
4f Report Bug or Enhancement. 
Cheat Sheets. 


Check for Updates 


About Eclipse 


1-24 选择 Install New Software 命 令 


(2) 在 弹出 的 Install 对 话 框 中 单 击 Add 按钮 ， 如 图 1-25 所 示 。 


F^ 
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Available Software 


Select a site or enter the location of « site. 


图 1-25 添加 插件 
G) 在 弹出 的 Add Site 对 话 框 中 分 别 输入 名 字 和 地 址 。 名 字 可 以 自己 命名 ， 例 如 
“123 ”， 但 是 在 Location 文本 框 中 必须 输入 插件 的 网 络 地 址 http://dl-ssl.google.com/ 
Android/eclipse/， 然 后 单 击 OK 按钮 ， 如 图 1-26 所 示 。 


图 1-26 设置 地 址 
(4) 此 时 在 Install 对 话 框 中 将 会 显示 系统 中 可 用 的 插件 ， 如 图 1-27 所 示 。 


Available Software 
Check the itens that you wish to install. 


[E - se 778-5. code se hteot eclipse] 


L1 Andress DE 0.9.5. «20091 11911220404 
EI Android Developaent Teols 0.9.5. v200811181123-20404 


(5) 选中 Android DDMS 和 Android Development Tools 插件 ， 然 后 单 击 Next 按钮 ， 进 
入 如 图 1-28 所 示 的 对 话 框 。 


0.9.5.v200911191123-20404 
3.3. 0. ve0091015-0500-e3x 
3.3.0. 120091015-0500-e3x 
3.3.0. ve0091015-0500-e3r £i 


图 1-28 Review Licenses Rm 
(6) 选中 I accept the terms of the license agreements 单 选 按钮 ， 然 后 单 击 Finish 按钮 ， 
开始 进行 安装 ， 如 图 1-29 所 示 。 


Æ Install (Blocked: The user operati... for background work to complete.) 


Fetching cos. android. ide. eclipse. a... adt, 0. 9. 9. v201009221407-60953. jar 


图 1-29 开始 安装 
在 上 述 步 又 中 ， 可 能 会 发 生 “计算 插件 占用 资源 ”的 情况 ， 整 个 计算 过 程 有 
点 慢 。 完 成 后 会 提示 重启 Eclipse 来 加 载 插件 ， 重 启 之 后 就 可 以 使 用 了 。 并 
且 不 同 版 本 的 Eclipse 安装 插件 的 方法 和 步骤 是 不 同 的 ， 但 是 都 大 同 小 异 ， 
读者 可 以 根据 操作 提示 自行 解决 。 


A 注意 : 


1.3.3 设 定 Android SDK 主 目录 


当 完 成 上 述 插件 的 安装 工作 后 ， 还 不 能 使 用 Eclipse 创建 Android 项 目 ， 还 需要 在 


Eclipse 中 设置 Android SDK 的 主 目录 。 
(1) 打开 Eclipse， 在 菜单 栏 中 依次 选择 Window | Preferences 命令 ， 如 图 1-30 所 示 。 
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图 1-30 选择 Preferences 命 令 


Q) 在 弹出 的 对 话 框 的 左 侧 选中 Android 选项 ， 在 右 侧 设 定 Android SDK 所 在 目录 为 
Fi\android-sdk-windows， 然 后 单 击 OK 按钮 完成 设置 ， 如 图 1-31 所 示 。 


[F:\android-sdirwindows [ 


图 1-31 Preferences 对 话 框 
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我 们 都 知道 程序 开发 需要 调试 ， 只 有 经 过 调试 之 后 才能 知道 程序 是 否 正 确 运行 。 作 为 
一 款 手机 系统 ， 我 们 如 何在 电脑 平台 之 上 调试 Android 程序 呢 ? 不 用 担心 ，Google 为 我 们 
提供 了 模拟 器 来 解决 这 个 问题 。 所 谓 模 拟 器 ， 就 是 指 在 电脑 上 模拟 Android 系统 ， 然 后 用 
这 个 模拟 器 来 调试 并 运行 开发 的 Android 程序 。 开 发 人 员 无 须 用 一 个 真实 的 Android 手 
机 ， 只 需 通过 电脑 模拟 运行 一 个 手机 ， 即 可 开发 出 应 用 在 手机 上 面 的 程序 。Android 模拟 
器 在 电脑 上 的 运行 效果 如 图 1-32 所 示 。 


- Andieid sss ainsi 


| See all your apps. 
TOUR the Launder VoD 


图 1-32 ”模拟 器 


1.4.1 Android 模拟 器 简介 


Android 模拟 器 的 全 称 是 Android Virtual Device, HKA AVD. XF Android 程序 的 
开发 者 来 说 ， 模 拟 器 的 推出 给 开发 者 带 来 了 极 大 的 方便 ， 无 论 是 在 开发 工作 上 还 是 在 测试 
工作 上 ， 无 论 在 Windows 环境 下 还 是 在 Linux 环境 下 ，Android 模拟 器 都 可 以 顺利 运行 。 
并 且 定 方 提供 了 Eclipse 插件 ， 可 以 将 模拟 器 集成 到 Eclipse 的 IDE 环境 。 当 然 ， 也 可 以 从 
命令 行 启动 Android 模拟 器 。 

获取 模拟 器 的 方法 非常 简单 ， 既 可 以 从 官方 站 点 (http://developer.Android.com/) 免 费 下 
载 单独 的 模拟 器 ， 也 可 以 先 下 载 Android SDK， 解 压 后 在 其 SDK 的 根 目 录 下 有 一 个 名 为 
tools 的 文件 夹 ， 此 文件 夹 下 包含 了 完整 的 模拟 器 和 一 些 非常 有 用 的 工具 。 

Android SDK 中 包含 的 模拟 器 的 功能 非常 齐全 ， 电 话 本 、 通 话 等 功能 都 可 正常 使 用 ( 当 
然 你 没 办 法 真 的 从 这 里 打 电 话 )。 甚 至 其 内 置 的 浏览 器 和 Maps 都 可 以 联网 。 用 户 可 以 通过 
键盘 输入 ， 或 者 通过 鼠标 点 击 模拟 器 按键 输入 ， 甚 至 还 可 以 使 用 鼠标 点 击 、 拖 动 屏幕 进行 
操纵 。 


1.4.2 ”模拟 器 和 真 机 的 区 别 


Android 模拟 器 不 能 完全 替代 真 机 ， 具 体 来 说 它们 有 如 下 差异 。 

Q ”模拟 器 不 支持 呼叫 和 接听 实际 来 电 ， 但 可 以 通过 控制 台 模拟 电话 呼叫 ( 呼 入 和 
呼出 )。 

模拟 器 不 支持 USB 连接 。 

模拟 器 不 支持 相机 /视频 捕捉 。 

模拟 器 不 支持 音频 输入 (捕捉 )， 但 支持 输出 ( 重 放 )。 

模拟 器 不 支持 扩展 耳机 。 

模拟 器 不 能 确定 连接 状态 。 

模拟 器 不 能 确定 电池 电量 状态 和 交流 充电 状态 。 
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o ”模拟 器 不 能 确定 SD 卡 的 插入 /弹出 。 
口 “” 模 拟 器 不 支持 蓝牙 。 


143 ”创建 Android 虚 拟 设备 


每 个 AVD 模拟 了 一 套 虚拟 设备 来 运行 Android 平台 ， 这 个 平台 至 少 要 有 自己 的 内 
核 、 系 统 图 像 和 数据 分 区 ， 还 可 以 有 自己 的 SD 卡 、 用 户 数据 以 及 外 观 显示 等 。 创 建 AVD 
的 基本 步骤 如 下 。 

(1) 单 击 Eclipse 菜单 中 的 图 标 国 ， 如 图 1-33 所 示 。 


to your task and ALM tools 
creste a local task 


图 1-33 ”Eclipse 界面 


(2) 弹出 Android SDK and AVD Manager 界面 ， 在 该 界面 的 左 侧 选择 Virtual devices 选 
项 ， 如 图 1-34 所 示 。 


@ Android SDK and AVD Manager 


1-34 Android SDK and AVD Manager ilii 
在 Virtual devices 设置 界面 中 列 出 了 当前 已 经 安装 的 AVD 版 本 ， 我 们 可 以 通过 界面 右 
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侧 的 按钮 来 创建 、 删 除 或 修改 AVD。 主 要 按钮 的 具体 说 明 如 下 。 
a 于。 创建 新 的 AVD， 单 击 此 按钮 在 弹出 的 界面 中 可 以 创建 一 个 新 AVD, du 
R| 1-35 所 示 。 


a : 修改 已 经 存在 的 AVD。 
a Ee. 删除 已 经 存在 的 AVD。 
a Fe: 启动 一 个 AVD 模拟 器 。 
r xi 
We 
Target 5 
CPU/ABT: Le] 
SD Card: 
G size: [ [ris 可 
cra: f[ — — — — ———23CJ J 
Snapshot: 
D Enabled 
Skin. 
G Built-in z] 
C Resolution: I 
Kar dvare 
Property | value | Wer. 
r 


图 1-35 新建 AVD 界 面 
SA 注意 : ”我 们 也 可 以 在 CMD 中 创建 或 删除 AVD， 例 如 可 以 按照 如 下 CMD 命令 创建 
一 个 AVD. 


android create avd --name «your avd name» --target <targetID> 


其 中 “your avd name” 是 需要 创建 的 AVD 的 名 字 ， 在 CMD 窗口 中 的 显示 
如 图 1-36 所 示 。 


图 1-36 ”CMD 窗口 
144 ”启动 AVD 模 拟 器 


在 调试 的 时 候 需 要 启动 AVD 模拟 器 。 启 动 AVD 模拟 器 的 基本 流程 如 下 。 


0 
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(1) 选择 图 1-34 所 示 列 表 中 名 为 “ mm” 的 AVD， 单 击 Start 按钮 ， 弹 出 Launch 
Options 对 话 框 ， 如 图 1-37 所 示 。 


Skin: HVGA (320x480) 
Density: Mediun (160) 


[ Scale display to real size 


[v Wipe user data 
Cancel 
图 1-37 Launch Options 对 话 框 


(2) 单 击 Launch 按钮 将 会 运行 名 为 “mm” 的 模拟 器 ， 如 图 1-38 所 示 。 


[E «e EC Coo.) 


a 


[^l vo S NCO.) 


DIE to fo 


sc a 


1-38 ”模拟 器 运行 成 功 


1.4.5 ”快速 安装 SDK 的 方法 


通过 Android SDK Manager 在 线 安装 的 速度 非常 慢 ， 而 且 有 时 容易 挂 掉 。 其 实 可 以 先 
从 网 络 中 寻找 SDK 资源 ， 用 迅雷 等 下 载 工具 下 载 后 ， 将 其 放 到 指定 目录 即 可 完成 安装 。 
具体 方法 是 先 下载 android-sdk-windows( 该 软件 需 能 更 新 )， 然 后 在 android-sdk-windows 下 
双击 setup.exe， 在 更 新 的 过 程 中 会 发 现 安装 Android SDK 的 速度 是 IKb/s， 此 时 打开 迅 
雷 ， 分 别 输入 下 面 的 地 址 : 


https://dl-ssl.google.com/android/repository/platform-tools r05- 


windows.zip 
https://dl-ssl.google.com/android/repository/docs-3.1 r01-linux.zip 
https://dl-ssl.google.com/android/repository/android-2.2 r02-windows.zip 
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https://dl-ssl.google.com/android/repository/android-2.3.3 r01-linux.zip 
https://dl-ssl.google.com/android/repository/android-2.1 r02-windows.zip 
https://dl-ssl.google.com/android/repository/samples-2.3.3 r01-linux.zip 
https://dl-ssl.google.com/android/repository/samples-2.2 r01-linux.zip 
https://dl-ssl.google.com/android/repository/samples-2.1 r01-linux.zip 
https://dl-ssl.google.com/android/repository/compatibility r02.zip 
https://dl-ssl.google.com/android/repository/tools rll-windows.zip 
https://dl-ssl.google.com/android/repository/google apis-10 r02.zip 
https://dl-ssl.google.com/android/repository/android-2.3.1 r02-linux.zip 
https://dl-ssl.google.com/android/repository/usb driver r04-windows.zip 
https://dl-ssl.google.com/android/repository/googleadmobadssdkandroid-4.1.0.zip 
https://dl-ssl.google.com/android/repository/market licensing-r01.zip 
https://dl-ssl.google.com/android/repository/market billing r0l.zip 
https://dl-ssl.google.com/android/repository/google apis-8 r02.zip 
https://dl-ssl.google.com/android/repository/google apis-7 r01.zip 
https://dl-ssl.google.com/android/repository/google apis-9 r02.zip 


可 以 继续 根据 自己 的 开发 要 求 选择 不 同 版 本 的 API 

下 载 完 后 将 它们 复制 到 android-sdk-windows/Temp 目录 下 ， 然 后 再 运行 setup.exe。 选 
中 需要 的 API 选项 ， 即 可 安装 。 记 得 把 原始 文件 保留 好 ， 因 为 放 在 Temp 目录 下 的 文件 安 
装 好 后 就 没有 了 。 


1.5 ”搭建 环境 过 程 中 的 常见 问题 


在 搭建 完成 开发 环境 后 ， 接 下 来 将 总 结 在 搭建 Android SDK 环境 过 程 中 出 现 过 的 问 
题 ， 帮 助 读者 在 实践 中 快速 成 功 搭建 Android 开发 环境 。 
1. 不 能 在 线 更 新 
在 安装 Android 后 ， 需 要 更 新 为 最 新 的 资源 和 配置 ， 但 是 在 启动 Android 后 ， 经 常会 
不 能 更 新 ， 弹 出 如 图 1-39 所 示 的 错误 提示 。 
se 过 


Fetching https://dl-ssl. google. con/androi d/reposi tory/reposi tory. xnl 


E 


failed to fetch URL https: //d1- = 
ssl. google. con/android/repository/repository.xml, reason: HTTPS 

error. You might want to force download through KITP in the 
settings. 


图 1-39 不 能 更 新 的 错误 提示 


Android 默认 的 在 线 更 新 地 址 是 https://dl-ssl.google.com/android/eclipse/， 但 是 经 常会 出 
现 错误 。 如 果 此 地 址 不 能 更 新 ， 可 以 自行 设置 更 新 地 址 ， 修 改 为 http://dl- 
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ssl.google.com/android/repository/repository.xml。 具 体操 作 方 法 如 下 。 
(1) 单 击 Android SDK and AVD Manager 对 话 框 左 侧 的 Available Packages 选项 ， 然 后 
单 击 Add Site..…. 按 钮 ， 如 图 1-40 所 示 。 


1-40 Android SDK and AVD Manager 对 话 框 


(2) 在 弹出 的 Add Site URL 对 话 框 中 输入 如 下 修改 后 的 地 址 ， 如 图 1-41 所 示 。 
http://dl-ssl.google.com/android/repository/repository.xml 


1-41 Add Site URL 对 话 框 
(3) 单 击 OK 按钮 完成 设置 ， 此 时 就 可 以 使 用 更 新 功能 了 ， 如 图 1-42 所 示 。 


Pel ES 


E android 网 络 开 发 从 入 门 到 精通 


2. 显示 “Project name must be specified” 提 示 


在 Eclipse 中 新 建 Android 工程 时 ， 一 直 显 示 “ 了 Project name must be specified” 提 示 ， 
如 图 1-43 所 示 。 


图 1-43 New Android Project 对 话 框 
造成 上 述 问题 的 原因 是 Android 没有 更 新 完成 ， 需 要 进行 完全 更 新 ， 具 体 方法 如 下 。 
(1) 打开 Android SDK and AVD Manager 对 话 框 ， 选 择 左 侧 的 Installed Packages 选 
项 ， 如 图 1-44 所 示 。 
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(2) 在 如 图 1-44 所 示 对 话 框 的 右 侧 列表 框 中 选择 Android SDK Tools, revision 4 选项 ， 
在 弹出 的 如 图 1-45 所 示 的 对 话 框 中 选中 Accept 单 选 按钮 ， 然 后 单 击 Install Accepted 按钮 
开始 安装 更 新 。 


图 1-45 Choose Packages to Install 对 话 框 
3. Target 列 表 中 没有 Target 选 项 


通常 来 说 ， 当 Android 开发 环境 搭建 完毕 后 ， 在 Eclipse 工具 栏 中 依次 选择 Window | 
Preferences 命令 ， 打 开 Preferences 对 话 框 , 单 击 左 侧 的 Android 选项 后 会 显示 存在 的 SDK 
Targets， 如 图 1-46 所 示 。 


i$ Tem 
ff Usage Data Collector 
Validation 
mL 


fg? 
SS 图: = 


1-46 SDK Targets 列 表 


可 是 往往 会 因为 各 种 原因 ， 而 不 显示 SDK Targets 列表 ， 并 且 在 图 1-31 所 示 的 对 话 框 
中 也 不 显示 ， 并 输出 “Failed to find an AVD compatible with target” 错 误 提 示 。 

造成 上 述 问题 的 原因 是 创建 AVD 没有 成 功 ， 此 时 需要 手工 安装 来 解决 这 个 问题 ， 当 
然 前 提 是 Android 已 更 新 完毕 。 具 体 解决 方法 如 下 。 
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(1) 在 “运行 ”对 话 框 中 输入 “CMD”， 打 开 CMD 窗口 ， 如 图 1-47 所 示 。 


Documents and Settings\Administrator> 


图 1-47 CMD 窗 口 
(2) 使 用 如 下 Android 命令 创建 一 个 AVD。 
android create avd --name «your avd name» --target «targetID» 


其 中 “your avd name” 是 需要 创建 的 AVD 的 名 字 ， 在 CMD 窗口 中 如 图 1-48 所 示 。 


e avd --name aa —--target 
ic findroid platform. 
ate a custom hardware profile [no] 


图 1-48 创建 名 为 “aa” 的 AVD 


图 1-48 所 示 的 窗口 中 创建 了 一 个 名 为 aa，targetID 为 3 的 AVD， 然 后 在 CMD 窗口 中 
输入 “n”， 即 完成 操作 ， 如 图 1-49 所 示 。 


ft Windov 
y 1985 


ttings \Administrator>android create avd --name aa —-target 3 
a basic findroid platforn. 


you wish to create a custom hardware profile [noln 
a’ based on Android 1.6, with the following hardware config: 


Documents and Settings Administrator? 


图 1-49 ”完成 操作 


N 
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Android 网 络 领域 的 范围 比较 广 ， 其 中 主要 包括 网 页 开 
发 、 远 程 通信 、 蓝 牙 通 信 、Wi-Fi 应 用 、 浏 览 器 开发 、 流 量 统 
计 和 邮件 处 理 等 知识 。 在 学 习 这 些 开发 知识 之 前 ， 读 者 需要 先 
了 解 一 些 基础 知识 后 才能 顺利 进行 。 从 本 章 开 始 ， 将 简要 讲解 
开发 Android 网 络 项 目的 基础 知识 ， 为 读者 步 入 本 书后 面 高 级 
知识 的 学 习 打 下 基础 。 
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2.4 Android 安装 文件 介绍 


当 我 们 下 载 并 安装 Android SDK 后 ， 会 在 安装 目录 中 看 到 一 些 安装 文件 。 这 些 文件 具 
体 是 干什么 用 的 呢 ? 在 本 节 的 内 容 中 ， 将 一 一 为 大 家 解 开 谜 题 。 


2.1.4 Android SDK 目 录 结 构 


安装 Android SDK 后 ， 其 安装 目录 的 结构 如 图 2-1 所 示 。 


日 (C3) android-sdk-windows 
comm 
B google apis-4 r02 
B google_apis-5_r01 
O google_apis-6_r01 
B google_apis-6_r0l-1 
O google_apis-6_r01-2 
E (C3 does 
© assets 
(© assets-sdk 
© community 
D mide 
© images 
© intl 
O reference 
B samples 
© sdk 
(© shareables 
© videos 
E B platforms 
(© sndroid-1.1 
O android-1.5 
O android-1.6 
O android-2.0 
O android-2.0.1 
© temp 
El © tools 
BB Jet 
(lib 
El O usb, driver 
(© amd64 
© i386 


图 2-1 安装 Android SDK 后 的 目录 结构 
Q add-ons: 包含 了 官方 提供 的 API 包 ， 最 为 主要 的 是 Map 的 API. 
Q docs: 包含 了 文档 ， 即 帮助 文档 和 说 明文 档 。 
Q platforms: 针对 每 个 版 本 的 SDK 版 本 提供 了 与 其 对 应 的 API 包 以 及 一 些 示 例文 
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件 ， 其 中 包含 了 各 个 版 本 的 Android, Anf 2-2 所 示 。 


图 2-2 platforms 目 录 项 
temp: 包含 了 一 些 常用 的 文件 模板 。 
tools: 包含 了 一 些 通用 的 工具 文件 。 


usb driver: 包含 了 AMD64 和 x86 下 的 驱动 文件 。 
SDK Setup.exe: Android 的 启动 文件 。 


2.1.2 androidjar 及 内 部 结构 


在 platforms 目录 下 的 每 个 Android 版 本 中 ， 都 有 一 个 名 为 android.jar 的 文件 。 例 如 
platforms\android-8 中 的 android.jar 文件 如 图 2-3 所 示 。 


DDODO 


DF: \andr oi d-sdk-windows\platforns\andr oi d-8 
 xHExHAGA 0v l| E: Bp ins ge images 
me O 外 ~ Ø 
android jar build N framework aidl 
图 Executable Jar File OPER 图 AIDL 文件 
5,306 KB 20 218 
j sdk. properties source, properties 
图 PROPERTIES 文件 PROPERTIES 文件 
15 15 


WR 00000000 Rim [JEE&E 7 
图 2-3 androidjar 文 件 所 在 目录 


androidjar 文件 是 一 个 标准 的 压缩 包 ， 其 中 包含 了 编译 后 的 压缩 文件 和 全 部 的 API。 
使 用 解压 缩 工具 可 以 打开 此 压缩 文件 ， 解 压 后 可 以 看 到 其 内 部 结构 如 图 2-4 和 图 2-5 
所 示 。 


; Android 网 络 开 发 从 入 门 到 精通 


图 2-5 androidjar 文 件 结构 


2.4.3 SDK 帮 助 文档 


要 想 深 入 理解 各 个 文件 包 内 包含 的 API 的 具体 用 法 ， 就 必须 学 会 阅读 和 查找 SDK H 
助 文档 。 读 者 可 以 使 用 浏览 器 打开 docs 目录 下 的 文件 index.html, ll 2-6 所 示 。 

在 图 2-6 所 示 的 主页 中 ， 显 示 了 Android 基本 概念 和 当前 常用 版 本 ， 在 页 面 右 侧 和 项 
端 导航 中 列 出 了 一 些 常用 的 链接 。 此 SDK 文件 对 于 初学 者 来 说 十 分 重要 ， 可 以 帮助 读者 
解决 很 多 常见 的 问题 ， 是 一 个 很 好 的 学 习 文档 和 帮助 文档 。 

单 击 导航 中 的 Dev Guide 标签 ， 打 开 如 图 2-7 所 示 的 页 面 。 
图 2-7 所 示 的 页 面 中 ， 左 侧 是 目录 索引 链接 ， 单 击 某 个 链接 ， 可 以 在 页 面 的 右 侧 显示 
对 应 的 说 明 信 息 。 下 面 我 们 对 各 个 索引 目录 链接 进行 简单 的 介绍 。 

如 果 要 想 迅速 地 理解 一 个 问题 或 知识 点 ， 可 以 在 搜索 对 话 框 中 对 SDK 进行 检索 ， 搜 
索 到 自己 需要 的 内 容 。 当 然 ， 很 多 热心 的 程序 员 和 学 者 对 SDK 进行 了 翻译 ， 网 络 上 面世 
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了 很 多 SDK 中 文 版 ， 感 兴趣 的 读者 可 以 从 网 络 中 获取 。 


T: Vandroi -sdl-windors Vlocs Vindex. html 
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Signing Your Applications. 
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图 2-6 ”SDK 文档 主页 


ev Guide 


Blog Videos Community 


The Developer's Guide 


Welcome to the Android Dev Guidel The Dev Guide is a practical introduction to developing applications for Android. It 
explores the concepts behind Android, the framework for constructing an application, and the tools for developing, 
testing, and publishing software for the platform. 


The Dev Guide holds most of the documentation for the Android platform, except for reference material on the 
framework API. For API specifications, go to the Reference tab above. 


As you can see in the panel on the left, the Dev Guide is divided into a handful of sections. They are 


Android Basics 
An initial orientation to Android — what it is, what it offers, and how your application fits in. 


Framework Topics 
Discussions of particular parts of the Android framework and API. For an overview of the framework, tegin with 
Application Fundamentals. Then explore othar topics — from designing a user interface and setting up resources 
to storing data and using permissions — as needed. 


Developing 
Directions for using Android's development and debugging tools, and for testing the results. 


Publishing 


2-7 ”SDK 文 档 目录 索引 


EJ Andicid 54545283 
24.4 解析 Android SDK 实 例 


在 Android SDK 的 安装 目录 中 有 一 个 名 为 samples 的 子 目 录 ， 在 其 中 保存 了 几 个 具有 
代表 性 的 演示 实例 。 这 些 实例 从 不 同 的 方面 展示 了 SDK 的 特性 和 强大 功能 。 例 如 ， 在 里 
面 有 一 个 名 为 “JetBoy” 的 实例 ， 此 实例 是 一 款 具备 声音 支持 的 游戏 实例 ， 它 模拟 演示 了 
如 何在 游戏 中 集成 SONiVOX 的 audioINSIDE 技术 的 过 程 ， 此 技术 是 SONiVOX 捐赠 给 手 
机 联盟 的 。 此 实例 可 以 完美 地 播放 背景 音乐 和 场景 ， 实 现 子 弹 击 碎 飞 来 障碍 物 等 一 系列 效 
果 。 执 行 后 的 效果 如 图 2-8 所 示 。 


e Raf G 4:01 PM 


pd we 


图 2-8 JetBoy 演 示 


2.2 分 析 Android 的 系统 架构 


本 节 将 详细 讲解 Android 应 用 程序 的 核心 构成 部 分 ， 为 读者 学 习 本 书后 面 的 网 络 应 用 
-发 打下 基础 。 


2.2.1 Android 体 系 结构 介绍 


Android 作为 一 个 移动 设备 的 平台 ， 其 软件 层次 结构 包括 操作 系统 (OS)、 中 间 件 
(MiddleWare) 和 应 用 程序 (Application)。 根 据 Android 的 软件 框图 ， 其 软件 层次 结构 自 下 而 
上 分 为 4 层 。 

Q ”操作 系统 层 (OS)。 

口 ” 各 种 库 (Libraries) 和 Android 运行 环境 (RunTime)。 

口 ” 应 用 程序 框架 (Application Framework). 

口 ” 应 用 程序 (Application)。 

上 述 各 个 层 的 具体 结构 如 图 2-9 所 示 。 
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图 2-9 Android 操 作 系统 的 组 件 结构 图 
1. 操作 系统 层 (OS) 


Android 使 用 Linux 2.6 作为 操作 系统 。Linux 2.6 是 一 种 标准 的 技术 ， 也 是 一 个 开放 的 
操作 系统 。Android 对 操作 系统 的 使 用 包括 核心 和 驱动 程序 两 部 分 ，Android 的 Linux 核心 
为 标准 的 Linux 2.6 内 核 ，Android 更 多 的 是 需要 一 些 与 移动 设备 相关 的 驱动 程序 。 主 要 的 
驱动 如 下 。 

口 “ 显 示 驱 动 (Display Driver): 常用 基于 Linux 的 帧 缓冲 (Frame Buffer) 驱 动 。 

Q Flash 内 存 驱 动 (Flash Memory Driver): 是 基于 MTD 的 Flash 驱动 程序 。 

口 “ 相 机 驱动 (Camera Driver): 常用 基于 Linux 的 v41(Video for Linux 的 缩写 ) 驱 动 。 

口 “ 音 频 驱 动 (Audio Driver): 常用 基于 ALSA(Advanced Linux Sound Architecture， 高 
级 Linux 声音 体系 ) 驱 动 。 

Wi-Fi 驱动 : 基于 IEEE 802.11 标准 的 驱动 程序 。 

键盘 驱动 (KeyBoard Driver): 作为 输入 设备 的 键盘 驱动 。 

蓝牙 驱动 (Bluetooth Driver): 基于 IEEE 802.15.1 标准 的 无 线 传输 技术 。 

Binder IPC 驱动 : 是 Android 一 个 特殊 的 驱动 程序 ， 具 有 单独 的 设备 节点 ， 提 供 
进程 间 通 信 的 功能 。 

Q Power Management( 能 源 管理 ): 管理 电池 电量 等 信息 。 

2. 各 种 库 (Libraries) 和 Android 运行 环境 (RunTime) 


本 层次 对 应 一 般 嵌 入 式 系统 ， 相 当 于 中 间 件 层次 。Android 的 本 层次 分 成 两 个 部 分 : 
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一 个 是 各 种 库 ， 另 一 个 是 Android 运行 环境 。 本 层 的 内 容 大 多 是 使 用 C 和 C++ 来 实现 的 。 
其 中 包含 的 各 种 库 如 下 。 

Q C 库 : C 语言 的 标准 库 ， 也 是 系统 中 一 个 最 为 底层 的 库 。C 库 是 通过 Linux 的 系 
统 调用 来 实现 。 

O 多 媒体 框架 (Media Framework): 这 部 分 内 容 是 Android 多 媒体 的 核心 部 分 ， 基 于 
Packet Video( 即 PV) 的 OpenCORE 。 从 功能 上 本 库 一 共 分 为 两 大 部 分 ， 一 部 分 是 
音频 、 视 频 的 回放 (PlayBack); 另 一 部 分 则 是 音频 、 视 频 的 记录 (Recorder)。 

O SGL: 2D 图 像 引擎 。 

Q SSL: Bill Secure Socket Layer 位 于 TCP/IP 协议 与 各 种 应 用 层 协议 之 间 ， 为 数据 通 

信 提 供 安 全 支持 。 

OpenGL ES 1.0: 提供 了 对 3D 的 支持 。 

界面 管理 工具 (Surface Management): 提供 了 对 管理 显示 子 系统 等 功能 。 
SQLite: 一 个 通用 的 嵌入 式 数据 库 。 

WebKit: 网 络 浏览 器 的 核心 。 

FreeType: 表示 位 图 和 矢量 字体 的 功能 。 

Android 的 各 种 库 一 般 是 以 系统 中 间 件 的 形式 提供 的 ， 它 们 均 有 一 个 显著 的 特点 ， 就 
是 与 移动 设备 的 平台 应 用 密切 相关 。 

Android 运行 环境 主要 是 指 的 虚拟 机 技术 一 一 Dalvik。Dalvik 虚拟 机 和 一 般 Java 虚拟 
机 (Java VM) 不 同 ， 它 执行 的 不 是 Java 标准 的 字 节 码 (Bytecode)， 而 是 Dalvik 可 执行 格式 
(.dex) 中 的 执行 文件 。 在 执行 的 过 程 中 ， 每 一 个 应 用 程序 即 一 个 进程 (Linux 的 一 个 
Process)。 二 者 最 大 的 区 别 在 于 Java VM 是 以 基于 栈 (Stack-based) 的 虚拟 机 ， 而 Dalvik 是 基 
于 寄存 器 (Register-based) 的 虚拟 机 。 显 然 ， 后 者 最 大 的 好 处 在 于 可 以 根据 硬件 实现 更 大 的 
优化 ， 这 更 适合 移动 设备 的 特点 。 

3. 应 用 程序 (Application) 

Android 的 应 用 程序 主要 是 用 户 界 面 (User Interface) 方 面 的 ， 通 常用 Java 语言 编写 ， 其 
中 还 可 以 包含 各 种 资源 文件 (放置 在 res 目录 中 )，Java 程序 及 相关 资源 经 过 编译 后 ， 将 生成 
一 个 APK 包 。Android 本 身 提供 了 主屏 幕 (Home)、 联 系 人 (Contact)、 电 话 (Phone)、 浏 览 器 
(Browser) 等 众多 的 核心 应 用 。 同 时 应 用 程序 的 开发 者 还 可 以 使 用 应 用 程序 框架 层 的 API 实 
现 自己 的 程序 ， 这 也 是 Android 开源 的 巨大 潜力 的 体现 。 

4. 应 用 程序 框架 (Application Framework) 

Android 的 应 用 程序 框架 为 应 用 程序 层 的 开发 者 提供 APIs， 它 实际 上 是 一 个 应 用 程序 
的 框架 。 由 于 上 层 的 应 用 程序 是 以 Java 构建 的 ， 因 此 本 层次 首先 包含 了 UI 程序 中 所 需要 
的 各 种 控件 ， 例 如 ，Views( 视 图 组 件 )， 其 中 又 包括 List( 列 表 )、Grid( 栅 格 )、Text Box( 文 本 
框 )、Button( 按 钮 ) 等 ， 甚 至 一 个 嵌入 式 的 Web 浏览 器 。 

一 个 基本 的 Android 应 用 程序 可 以 利用 应 用 程序 框架 中 的 以 下 五 个 部 分 。 

Q Activity). 

Q Broadcast Intent Receiver( 广 播 意图 接收 者 )。 

OQ ”Service( 服 务 )。 


[9 | 
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QU Content Provider( 内 容 提供 者 )。 
口 Intent and Intent Filter( 意 图 和 意图 过 滤器 )。 


2.2.2 ”Android 工 程 文件 结构 


Android 的 应 用 工程 文件 主要 由 以 下 部 分 组 成 。 
src 目录 : 项 目 源 文件 都 保存 在 该 目录 中 。 
Rjava 文件 :该 文件 是 Eclipse 自动 生成 的 ， 应 用 开发 者 不 需要 去 修改 其 中 的 内 容 。 
Android Library: 这 个 是 应 用 运行 的 Android 库 。 

assets 目录 : 主要 放置 多 媒体 等 一 些 文件 。 

res 目录 : 主要 放置 应 用 到 的 资源 文件 。 

drawable 目录 : 主要 放置 应 用 到 的 图 片 资源 。 

layout 目录 : 主要 放置 用 到 的 布局 文件 ， 这 些 布局 文件 都 是 XML 文件 。 

values 目录 : 主要 放置 字符 串 (strings.xml)、 颜 色 (colors xmD)、 数 组 (arrays.xml)。 
AndroidManifest.xml: 相当 于 应 用 的 配置 文件 。 在 这 个 文件 中 ， 必 须 声 明 应 用 的 
名 称 ， 应 用 所 用 到 的 Activity, Service 以 及 receiver 等 。 

在 Eclipse 中 ， 一 个 基本 的 Android 项 目的 目录 结构 如 图 2-10 所 示 。 


DODDDDOODGOUO 


E con. exanplell 

GB javax. game 

[J] Layer. java 

四 LayerManager. java 
[J) Sprite. java 

国 TiledLayer. java 
[Generated Java Files] 


[cocoa CoC) 


" 
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com. exanplell 
D) R. java 
BA Android 3.0 
Gs. assets 
日 -名 res 
C» drawable 
| ERES layout 
f (X) main. xml 
| -ran 
| EB values 
: DÒ strings. xml 


E 


— £i Androi dlfani fest. xml 
default. properties 


图 2-10 Android 应 用 工程 文件 组 成 
1. src 目 录 、res 目 录 及 R.java 文 件 
与 一 般 的 Java 项 目 一 样 ，src 目录 下 保存 的 是 项 目的 所 有 包 及 源 文件 (.java); res 目录 
下 包含 了 项 目 中 的 所 有 资源 ， 例 如 ， 程 序 图 标 (drawable)、 布 局 文件 (layout) 和 常量 (values) 
等 。 不 同 的 是 ， 在 Java 项 目 中 没有 gen 目录 ， 也 没有 每 个 Android 项 目 都 必须 有 的 
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AndroidManfest.xml 文件 。 

java 格式 文件 是 在 建立 项 目 时 自动 生成 的 ， 该 文件 是 只 读 模 式 ， 不 能 更 改 。Rjava X 
件 是 定义 该 项 目 所 有 资源 的 索引 文件 。 下 面 先 来 看 看 HelloAndroid 项 目的 Rjava 文件 ， 例 
如 下 面 的 代码 : 


package com.yarin.Android.HelloAndroid; 
public final class R ( 
public static final class attr ( 
) 
public static final class drawable ( 
public static final int icon-0x7f020000; 


) 

public static final class layout ( 
public static final int main-0x7f030000; 

) 

public static final class string ( 
public static final int app name-0x7f040001; 
public static final int hello-0x7f040000; 


) 

从 上 述 代码 中 ， 可 以 看 到 定义 了 很 多 常量 ， 并 且 会 发 现 这 些 常 量 的 名 字 都 与 res 目录 
中 的 文件 名 相同 ， 这 再 次 证 明 .java 文件 中 所 存储 的 是 该 项 目 所 有 资源 的 索引 。 有 了 这 个 文 
件 ， 在 程序 中 使 用 资源 将 变 得 更 加 方便 ， 可 以 很 快 地 找到 要 使 用 的 资源 ， 由 于 这 个 文件 不 
能 被 手动 编辑 ， 所 以 当 我 们 在 项 目 中 加 入 了 新 的 资源 时 ， 只 需要 刷新 一 下 该 项 目 ，Jjava 文 
件 便 自动 生成 了 所 有 资源 的 索引 。 

2. 文件 AndroidManfest.xml 


在 文件 AndroidManfest.xml 中 包含 了 该 项 目 中 所 使 用 的 Activity. Service. Receiver. 
下 面 是 HelloAndroid 项 目 中 的 AndroidManfest.xml 文件 。 


<?xml version-"1.0" encoding-"utf-8"?» 

«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package-"com.yarin.Android.HelloAndroid" 
android:versionCode-"1" 
android:versionName-"1.0"» 

«application android:icon="@drawable/icon" 
android: label="@string/app name"? 
<activity android:name=".HelloAndroid" 
android: label="@string/app name"> 
<intent-filter> 
<action android:name="android.intent.action.MAIN" /> 
<category android:name-"android.intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 
</application> 
«uses-sdk android:minSdkVersion-"5" /> 
«/manifest» 


在 上 述 代码 
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P, intent-filter 描述 了 Activity 启动 的 位 置 和 时 间 。 每 当 一 个 Activity( 或 


者 操作 系统 ) 要 执行 一 个 操作 时 ， 它 将 创建 出 一 个 Intent 的 对 象 ， 这 个 Intent 对 象 能 承载 的 
信息 可 描述 你 想 做 什么 、 你 想 处 理 什么 数据 、 数 据 的 类 型 ， 以 及 一 些 其 他 信息 。 而 
Android 则 会 和 每 个 Application 所 暴露 的 intent-filter 的 数据 进行 比较 ， 找 到 最 合适 Activity 
来 处 理 调用 者 所 指定 的 数据 和 操作 。 下 面 来 仔细 分 析 AndroidManfestxml 文件 ， 如 表 2-1 


所 示 。 
表 2-1 AndroidManfest.xml 分 析 
参 HK 说 mg 

manifest 根 节点 ， 描 述 了 Package 中 所 有 的 内 容 

ged 包含 命名 空间 的 声明 。xmlns:android=http://schemas.android.com/apk/res/android , 
Xsandroi | 使 得 Android 中 各 种 标准 届 性 能 在 文件 中 使 用 ， 提 供 了 大 部 分 元 素 中 的 数据 
Package 声明 应 用 程序 包 

包含 Package 中 Application 级 别 组件 声 明 的 根 节点 。 此 元 素 也 可 包含 Application 

application 的 一 些 全 局 和 默认 的 属性 ， 如 标签 、icon、 主 题 、 必 要 的 权限 ， 等 等 。 一 个 


android:icon 
android:label 


Activity 


manifest 能 包含 零 个 或 一 个 此 元 素 ( 不 能 大 于 一 个 ) 

应 用 程序 图 标 

应 用 程序 名 字 

用 来 与 用 户 交互 的 主要 工具 。Activity 是 用 户 打开 一 个 应 用 程序 的 初始 页 面 ， 大 部 
分 被 使 用 到 的 其 他 页 面 也 由 不 同 的 Activity 所 实现 ， 并 声明 在 另外 的 Activity 标记 
中 。 注 意 ， 每 一 个 Activity 必须 有 一 个 <activity> 标 记 对 应 ， 无 论 它 被 外 部 使 用 还 
是 只 用 于 自己 的 Package 中 。 如 果 一 个 Activity 没有 对 应 的 标记 ， 将 不 能 运 。 
另外 ， 为 了 支持 运行 时 查找 Activity， 可 包含 一 个 或 多 个 <intent-filter> 元 素来 描述 


Activity 所 支持 的 操作 
android:name 应 用 程序 默认 启动 的 Activity 


intent-filter 


声明 了 指定 的 一 组 组 件 支持 的 Intent 值 ， 从 而 形成 了 Intent Filter。 除 了 能 在 此 元 
素 下 指定 不 同类 型 的 值 ， 属 性 也 能 放 在 这 里 来 描述 一 个 操作 所 需 的 唯一 的 标签 、 
icon 和 其 他 信息 


action 组 件 支持 的 Intent action. 
category 组 件 支持 的 Intent Category。 这 里 指定 了 应 用 程序 默认 启动 的 Activity 
uses-sdk 该 应 用 程序 所 使 用 的 SDK 版 本 相关 


3. 常量 的 定义 文件 
下 面 看 看 资源 文件 中 一 些 常量 的 定义 ， 如 String.xml， 例 如 下 面 的 代码 : 


«?xml version-"1.0" encoding-"utf-8"?» 


«resources» 


«string 
«string 


name="hello">Hello World, HelloAndroid!</string> 
name-"app name">HelloAndroid</string> 


</resources> 
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上 述 的 代码 非常 简单 ， 只 定义 了 两 个 普通 的 字符 串 资 源 。 
下 面 来 分 析 HelloAndroid 项 目的 布局 文件 (layout)。 首 先 打 开 文 件 
res\layoutimain.xml， 其 代码 如 下 : 


<?xml version-"1.0" encoding-"utf-8"?» 
<LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:orientation-"vertical" 

android:layout width-"fill parent" 
android:layout height-"fill parent" 
uos 

«TextView 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text-"Gstring/hello" 
/> 

</LinearLayout> 


在 上 述 代码 中 ， 有 以 下 几 个 布局 和 参数 。 

口 “<LinearLayout></LinearLayout>: 线性 版 面 配 置 ， 在 这 个 标签 中 ， 所 有 元 件 都 是 
按 由 上 到 下 的 顺序 排 成 的 。 

Q  android:orientation: 表示 这 个 介质 的 版 面 配置 方式 是 从 上 到 下 垂直 地 排列 其 内 部 


的 视图 。 

Q  android.ayout width: 定义 当前 视图 在 屏幕 上 所 占 的 宽度 ，fill_parent 即 填充 整个 
屏幕 。 

ū android:layout_height: 定义 当前 视图 在 屏幕 上 所 占 的 高 度 ，fil_parent 即 填充 整个 
屏幕 。 


Q wrap content: 随 着 文字 栏 位 的 不 同 而 改变 这 个 视图 的 宽度 或 高 度 。 

在 上 述 布局 代码 中 ， 使 用 了 一 个 TextView 来 配置 文本 标签 Widget( 构 件 )， 其 中 设置 的 
属性 android:layout width 为 整个 屏幕 的 宽度 ，android:layout height 可 以 根据 文字 来 改变 高 
度 ， 而 android:text 则 设置 了 这 个 TextView 要 显示 的 文字 内 容 ， 这 里 引用 了 @string 中 的 
hello 字符 串 ， 即 String.xml 文件 中 的 hello 所 代表 的 字符 串 资源 。hello 字符 串 的 内 容 

“Hello World, HelloAndroid!” 就 是 我 们 在 HelloAndroid 项 目 运行 时 看 到 的 字符 串 。 

GF 注意 : 上面 介绍 的 文件 只 是 主要 文件 ， 在 项 目 中 需要 我 们 自行 编写 。 在 项 目 中 还 有 
很 多 其 他 的 文件 ， 那 些 文件 很 少 需要 我 们 自己 编写 ， 所 以 在 此 就 不 进行 讲 
解 了 。 


2.2.3 ”应 用 程序 的 生命 周期 


程序 也 如 同 自然 界 的 生物 一 样 ， 有 自己 的 生命 周期 。 应 用 程序 的 生命 周期 即 程序 的 存 
活 时 间 ， 即 在 哪 段 时 间 内 有 效 。Android 是 一 个 构建 在 Linux 之 上 的 开源 移动 开发 平台 ， 
在 Android 中 ， 多 数 情况 下 每 个 程序 都 是 在 各 自 独立 的 Linux 进程 中 运行 的 。 当 一 个 程序 
或 其 某 些 部 分 被 请 求 时 ， 它 的 进程 就 “出 生 ” 了 ; 当 这 个 程序 没有 必要 再 运行 下 去 且 系 统 
需要 回收 这 个 进程 的 内 存 用 于 其 他 程序 时 ， 这 个 进程 就 “死亡 ”了 。 可 以 看 出 ，Android 
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程序 的 生命 周期 是 由 系统 控制 而 非 程序 自身 直接 控制 。 这 和 我 们 编写 桌面 应 用 程序 时 的 思 
维 有 些 不 同 ， 一 个 桌面 应 用 程序 的 进程 也 是 在 其 他 进程 或 用 户 请 求 时 被 创建 ， 但 是 往往 是 
在 程序 自身 收 到 关闭 请 求 后 执行 一 个 特定 的 动作 (比如 从 main. 函数 中 返回 ) 而 导致 进程 结束 
的 。 要 想 做 好 某 种 类 型 的 程序 或 者 某 种 平台 下 的 程序 开发 ， 最 关键 的 就 是 要 和 弄 清 楚 这 种 类 
型 的 程序 或 整个 平台 下 的 程序 的 一 般 工 作 模式 ， 并 熟 记 在 心 。 在 Android H, 程序 的 生命 
周期 控制 就 属于 这 个 范畴 。 

开发 者 必须 理解 不 同 的 应 用 程序 组 件 ， 尤 其 是 Activity、Service 和 Intent Receiver。 了 
解 这 些 组 件 是 如 何 影 响应 用 程序 生命 周期 的 ， 这 非常 重要 。 如 果 不 正 确 地 使 用 这 些 组 件 ， 
可 能 会 导致 系统 终止 正在 执行 重要 任务 的 应 用 程序 进程 。 

一 个 常见 的 进程 生命 周期 漏洞 的 例子 是 Intent Receiver( 意 图 接收 器 )， 当 Intent 
Receiver 在 onReceive 方法 中 接收 到 一 个 Intent( 意 图 ) 时 ， 它 会 启动 一 个 线程 ， 然 后 返回 。 
一 旦 返回 ， 系 统 将 认为 Intent Receiver 不 再 处 于 活动 状态 ， 因 而 Intent Receiver 所 在 的 进程 
也 就 不 再 有 用 了 (除非 该 进程 中 还 有 其 他 的 组 件 处 于 活动 状态 )。 因 此 ， 系 统 可 能 会 在 任意 
时 刻 终止 该 进程 以 回收 占有 的 内 存 。 这 样 进程 中 创建 出 的 那个 线程 也 将 被 终止 。 解 决 这 个 
问题 的 方法 是 从 Intent Receiver 中 启动 一 个 服务 ， 让 系统 知道 进程 中 还 有 处 于 活动 状态 的 
工作 。 为 了 使 系统 能 够 正确 决定 在 内 存 不 足 时 应 该 终止 哪个 进程 ，Android 根据 每 个 进程 
中 运行 的 组 件 及 组 件 的 状态 把 进程 放 入 一 个 “Importance Hierarchy( 重 要 性 分 级 )” 中 。 进 
程 的 类 型 按 重要 程度 如 下 排序 。 

1. 前 台 (Foreground) 进 程 

前 台 进 程 与 用 户 当前 正在 做 的 事情 密切 相关 。 不 同 的 应 用 程序 组 件 能 够 通过 不 同 的 方 
法 将 它 的 宿主 进程 移 到 前 台 。 在 如 下 的 任何 一 个 条 件 下 : 进程 正在 屏幕 的 最 前 端 运行 一 个 
与 用 户 交 互 的 活动 (Activity)， 它 的 onResume 方法 被 调用 ; 或 进程 有 一 正在 运行 的 Intent 
Receiver( 它 的 IntentReceiver.onReceive 方法 正在 执行 ); 或 进程 有 一 个 服务 (Service)， 并 且 
在 服务 的 某 个 回调 函数 (Service.onCreate、Service.onStart 或 Service.onDestroy) 内 有 正在 执 
行 的 代码 ， 系 统 将 把 进程 移动 到 前 台 。 

2. 可 见 (Visible) 进 程 

可 见 进程 有 一 个 可 以 被 用 户 从 屏幕 上 看 到 的 活动 ， 但 不 在 前 台 ( 它 的 onPause 方法 被 调 
用 )。 例 如 ， 如 果 前 台 的 活动 是 一 个 对 话 框 ， 以 前 的 活动 就 隐藏 在 对 话 框 之 后 ， 就 会 出 现 这 
种 进程 。 可 见 进程 非常 重要 ， 一 般 不 允许 被 终止 ， 除 非 是 为 了 保证 前 台 进 程 的 运行 而 不 得 
不 终止 它 。 

3. 服务 (Service) 进 程 


服务 进程 拥有 一 个 已 经 用 startService 方法 启动 的 服务 。 虽 然 用 户 无 法 直接 看 到 这 些 进 
程 ， 但 它们 做 的 事情 却 是 用 户 所 关心 的 ， 如 后 台 MP3 回放 或 后 台 网 络 数据 的 上 传 、 下 
载 。 因 此 ， 系 统 将 一 直 运行 这 些 进程 ， 除 非 内 存 不 足以 维持 所 有 的 前 台 进 程 和 可 见 进 程 。 


4. 后 台 (Background) 进 程 
后 台 进 程 拥有 一 个 当前 用 户 看 不 到 的 活动 ( 它 的 onStop 方法 被 调用 )。 这 些 进 程 对 用 户 
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体验 没有 直接 的 影响 。 如 果 它 们 正确 执行 了 活动 生命 周期 ， 系 统 可 以 在 任意 时 刻 终止 该 进 
程 以 回收 内 存 ， 并 提供 给 前 面 三 种 类 型 的 进程 使 用 。 系 统 中 通常 有 很 多 这 样 的 进程 在 运 
行 ， 因 此 要 将 这 些 进 程 保存 在 LRU 列表 中 ， 以 确保 当 内 存 不 足 时 用 户 最 近 看 到 的 进程 最 
后 一 个 被 终止 。 

5. 空 (Empty) 进 程 

室 进 程 是 不 拥有 任何 活动 的 应 用 程序 组 件 的 进程 。 保 留 这 种 进程 的 唯一 原因 是 在 下 次 
应 用 程序 的 某 个 组 件 需要 运行 时 ， 不 需要 重新 创建 进程 ， 这 样 可 以 提高 启动 速度 。 

系统 将 以 进程 中 当前 处 于 活动 状态 组 件 的 重要 程度 为 基础 对 进程 进行 分 类 。 进 程 的 优 
先 级 可 能 也 会 根据 该 进程 与 其 他 进程 的 依赖 关系 而 提升 。 例 如 ， 如 果 进 程 A 通过 在 进程 B 
中 设置 ContextBIND_ AUTO CREATE 标记 或 使 用 ContentProvider 被 绑 定 到 一 个 服务 
(Service)， 那 么 进程 B 在 分 类 时 至 少 要 被 看 成 与 进程 A 同等 重要 。 

例如 Activity 的 状态 转换 图 如 图 2-11 所 示 。 


Activity 启 动 


用 BACK 键 关 
闭 此 Activity 


结束 进程 


另 一 个 活动 来 到 前 台 


Activity 
如 果 其 他 应 用 在 前 台 运行 


需要 内 存 


图 2-11 Activity 状态 转换 图 
图 2-11 所 示 的 状态 的 变化 是 由 Android 内 存 管理 器 决定 的 ，Android 会 首先 关闭 那些 
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包含 Inactive Activity 的 应 用 程序 ， 然 后 关闭 Stopped( 已 停止 ) 状 态 的 程序 。 在 极端 情况 
下 ， 会 移 除 Paused( 暂 停 ) 状 态 的 程序 。 
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在 作者 写作 本 书 时 ， 移 动 上 网 设备 已 经 超越 电脑 。 由 此 可 以 推断 出 ， 有 众多 的 用 户 使 
用 手机 等 移动 设备 进行 网 上 冲浪 。 所 以 对 于 Android 网 络 应 用 程序 员 来 说 ， 很 有 必要 掌握 
在 Android 手机 中 开发 网 页 的 知识 。 


2.3.1 HTML 简介 


HTML 是 由 标记 组 成 的 一 种 网 页 标记 语言 ， 当 前 几乎 所 有 的 网 页 都 是 通过 HTML 展现 
在 我 们 眼前 的 。 目 前 最 新 的 HTML 版 本 是 刚刚 推出 的 HTML 5. 
1. HTML 基 本 结构 
HTML 是 一 种 网 页 标记 语言 ， 它 的 所 有 部 分 都 是 标记 <> 和 </> 括 起 来 。 来 看 下 面 的 
代码 : 
«html» 
«head» 
<title> 这 是 网 页 的 标题 标签 </title> 
</head> 
<body> 
这 是 网 页 内 容 
«body» 
</html> 
上 面 展 示 的 代码 ， 其 实 就 是 一 个 很 简单 的 网 页 ， 网 页 就 是 通过 这 种 方式 展现 给 浏览 
其 中 各 个 参数 介绍 如 下 。 
口 “<html>…</html>: 这 是 HTM 标签 ， 所 有 标记 都 要 放 在 这 里 ，<html> 是 开始 标 
签 ，</html> 是 标签 的 结束 。 
口 ”<head>…</head>: 表示 网 页 的 头 部 。 
口 ”<title>…</ title >: 表示 网 页 的 标题 。 
口 ”<body>…</body>: 表示 网 页 的 内 容 。 


2. HTML 标 记 特 性 


HTML 必须 以 <html> 开 始 ， 以 </html> 结 束 ， 文 件 头 包含 在 <head>…</head> 里 面 ， 文 
件 体 包含 在 <body>…</body> 里 面 ， 在 文件 头 部 ， 用 户 可 以 用 <title>…</title> 标 记 来 声明 文 
件 标题 。 在 HTML 文档 中 ， 值 得 提醒 读者 的 是 HTML 也 有 注释 ， 它 和 Java 是 完全 不 同 
W, HTML 采用 <! 一 注释 --> 来 标记 注释 ， 在 HTML 中 ， 每 一 个 标记 都 是 成 对 出 现 。 下 面 
展示 一 段 代码 。 
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<html> 

<head> 

<title> 欢 迎 进入 Java 网 络 世界 </title> 
</head> 

<body> 

这 里 是 Java 网 络 世界 ! 

<body> 

</html> 


将 上 述 文件 以 html 扩展 名 保存 ， 双 击 打开 后 会 得 到 如 图 2-12 所 示 的 效果 。 


[和 Te 
VO MS sv HALO HAT 


这 里 是 Java 网 络 世界 ! 


Bm HL 
图 2-12 用 HTML 实 现 的 一 个 网 页 
Kj 注意 :i HTM 技术 虽然 比较 简单 ， 但 它 是 我 们 开发 网 页 的 基础 。 因 为 HTML 不 是 本 


书 的 重点 ， 如 果 读 者 对 HTML 技术 不 是 很 熟悉 ， 建 议 参 考 相 关 图 书 和 网 络 资 
料 来 学 习 掌握 。 


2.8.06 ”XML 技术 


XML 是 eXtensible Markup Language 的 缩写 ， 表 示 可 扩展 标记 语言 。XML 与 HTML 一 
样 ， 都 是 SGML(Standard Generalized Markup Language， 标 准 通用 标记 语言 )。XML 是 
Internet 环 境 中 跨 平台 的 、 依 赖 于 内 容 的 技术 ， 是 当前 处 理 结构 化 文档 信息 的 有 力 工具 。 扩 
展 标记 语言 XML 是 一 种 简单 的 数据 存储 语言 ， 使 用 一 系列 简单 的 标记 描述 数据 ， 而 这 些 标 
记 可 以 用 方便 的 方式 建立 。 虽 然 XML 比 二 进 制 数据 要 占用 更 多 的 空间 ， 但 XML 极其 简 
单 ， 易 于 掌握 和 使 用 。 


1. XML 的 概述 


XML 与 Access、Oracle 和 SQL Server 等 专业 数据 库 不 同 ， 这 些 专业 数据 库 提供 了 更 强 
有 力 的 数据 存储 和 分 析 能 力 ， 例 如 ， 数 据 索引 、 排 序 、 查 找 、 相 关 一 致 性 等 ， 而 XML 仅仅 
实现 了 展示 数据 的 功能 。 事 实 上 XML 与 其 他 数据 表现 形式 最 大 的 不 同 是 极其 简单 。 但 正 是 
这 点 使 XML 与 众 不 同 。 

XML 的 简单 使 其 易于 在 任何 应 用 程序 中 读 写 数据 ， 这 使 XML 很 快 成 为 数据 交换 的 唯 
一 公共 语言 ， 虽 然 不 同 的 应 用 软件 也 支持 其 他 的 数据 交换 格式 ， 但 不 久之 后 它们 都 将 支持 
XML， 那 就 意味 着 程序 可 以 更 容易 地 与 Windows. Mac OS. Linux 以 及 其 他 平台 下 产生 的 
信息 结合 ， 然 后 可 以 很 容易 加 载 XML 数据 到 程序 中 并 进行 分 析 ， 并 以 XML 格式 输出 
结果 。 
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为 了 使 得 SGML 显得 用 户 友好 ，XML 重新 定义 了 SGML 的 一 些 内 部 值 和 参数 ， 去 掉 
了 大 量 的 很 少 用 到 的 功能 ， 这 些 繁杂 的 功能 使 得 SGML 在 设计 网 站 时 显得 复杂 化 。XML 
保留 了 SGML 的 结构 化 功能 ， 这 样 就 使 得 网 站 设计 者 可 以 定义 自己 的 文档 类 型 ，XML 同 
时 也 推出 一 种 新 型 文档 类 型 ， 使 得 开发 者 也 可 以 不 必定 义 文档 类 型 。 
因为 XML 是 W3C 制 定 的 ，XML 的 标准 化 工作 由 W3C 的 XML 工作 组 负责 ， 该 小 组 成 员 
来 自 各 个 地 方 和 行业 的 专家 组 成 ， 他 们 通过 Email 交流 对 XML 标准 的 意见 ， 并 提出 自己 
的 看 法 (www.w3.org/TR/WD-xmlD)。 因 为 XML 是 个 公共 格式 ， 它 不 专属 于 任何 一 家 公司 ， 
所 以 不 必 担 心 XML 技术 会 成 为 少数 公司 的 多 利 工具 。 


2. XML 的 语法 


上 面 虽然 讲解 了 XML 的 特点 ， 但 是 初学 者 仍然 不 明白 XML 是 用 来 做 什么 的 。 其 实 
XML 什么 也 不 做 ， 它 只 是 用 来 存储 数据 的 ， 对 HTML 语言 进行 扩展 。 它 和 HTML 分 工 很 
明显 ，XML 是 用 来 存储 数据 ， 而 HTML 是 用 来 如 何 表现 数据 的 。 下 面 通过 一 段 演示 代码 
进行 讲解 。 

<?xml version-"1.0" encoding-"utf-8"?» 

«book» 

«person» 

<first>Kiran</first> 

<last>Pai</last> 

<age>22</age> 

</person> 

<person> 

<first>Bill</first> 

<last>Gates</last> 

<age>46</age> 

</person> 

<person> 

<first>Steve</first> 

<last>Jobs</last> 

<age>40</age> 

</person> 

</book> 


上 面 的 语法 不 但 可 以 这 么 写 ， 只 要 符合 语法 还 可 以 写成 汉语 ， 如 下 面 的 代码 
(3-3.xml): 


<?xml version-"1.0" encoding-"utf-8"?» 
< 项 目 > 
< 名 > 天 上 星 </ 名 > 
< 电子 邮件 >tianshangxingehotmail.com</ 电 子 邮 件 > 
< 住宅 > 何 国 何 市 何 区 何 街道 何 番 号 </ 住 宅 > 
< 电话 >86-021-742745674</ 电 话 > 
< 一 言 >XME 学 习 </ 一 言 > 


</ 项 目 > 


从 上 面 两 段 代码 可 以 看 出 ，XML 的 标记 完全 自由 定义 ， 不 受 约束 ， 它 只 是 用 来 存储 
信息 。 除 了 第 一 行 固定 以 外 ， 其 他 的 只 需要 前 后 标签 一 致 ， 不 能 省 掉 末 标签 。 下 面 是 对 
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XML 语法 格式 的 总 结 。 
口 “” 第 一 行 要 对 XML 进行 声明 ， 也 就 是 XML 的 版 本 。 
Q XML 的 标记 和 HTML 一 样 是 成 双 成 对 出 现 的 。 
Q XML 对 标记 的 大 小 写 十 分 敏感 。 
Q XML 标记 是 用 户 自行 定义 ， 但 是 每 一 个 标记 必须 有 结束 标记 。 
GER: XML 技术 虽然 比较 简单 ， 但 是 我 们 开发 网 页 的 基础 。 因 为 XML 不 是 本 书 的 
重点 ， 如 果 读 者 对 XML 技术 不 是 很 熟悉 ， 建 议 参 考 相关 图 书 和 网 络 资料 来 
学 习 掌握 。 


2.8.9 CSS 技术 


CSS 技术 是 Web 网 页 技术 的 重要 组 成 ， 页 面 通过 CSS 的 修饰 可 以 实现 用 户 需要 的 显 
示 效 果 。 因 为 在 现实 应 用 中 经 常用 到 的 CSS 元 素 是 选择 符 、 属 性 和 值 ， 所 以 在 CSS 的 应 
用 语法 中 其 主要 应 用 格式 也 主要 涉及 上 述 3 种 元 素 。CSS 的 基本 语法 结构 如 下 : 

<style type="text/css"> 

«1-- 

-选择 符 { 属 性 : fü) 

--> 

</style> 


其 中 ，CSS 选择 符 的 种 类 有 多 种 ， 并 且 命名 机 制 也 不 相同 。 例 如 下 面 的 代码 演示 了 
CSS 技术 在 网 页 中 的 作用 。 

«html» 

<head> 


«meta http-equiv-"Content-Type" content-"text/html; charset-utf-8"» 
<title> 无 标题 文档 </title> 


<style type="text/css"> <!-- 设 置 的 样式 --> 

a 

.mm ( 
font-family: "Times New Roman", Times, serif; /* 设 置 字 体 */ 
font-size: 18px; /* 设 置 字体 大 小 */ 
font-weight: bold; /* 加 粗 字 体 */ 
color: #990000; /* 设 置 颜色 */ 

--> 

</style> 

</head> 

<body class="mm"> <!-- 文 本 调用 样式 --> 

我 的 未 来 不 是 梦 

</body> 

</html> 


执行 后 的 效果 如 图 2-13 所 示 。 
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图 2-13 执行 效果 
Aj 注意 ; ”CSS 技术 虽然 比较 简单 ， 但 是 我 们 开发 网 页 的 基础 。 因 为 CSS 不 是 本 书 的 重 
点 ， 如 果 读 者 对 CSS 技术 不 是 很 熟悉 ， 建 议 参 考 相关 图 书 和 网 络 资料 来 学 习 


掌握 。 
2.3.4 _ JavaScript 技术 


JavaScript 是 一 种 脚本 技术 ， 页 面 通过 脚本 程序 可 以 实现 用 户 数据 的 传输 和 动态 交互 。 
JavaScript 是 一 种 基于 对 象 (Object) 和 事件 驱动 (Event Driven) 并 具有 安全 性 能 的 脚本 语言 。 
其 目的 是 与 HTML 超 文本 标记 语言 、Java 脚本 语言 (Java 小 程序 ) 相 互 结 合 ， 实 现 Web 页 
面 中 链接 多 个 对 象 ， 并 与 Web 客户 交互 的 效果 ， 从 而 实现 客户 端 应 用 程序 的 开发 。 

使 用 JavaScript 技术 的 基本 语法 格式 如 下 : 

«Script Language ="JavaScript"> 


JavaScript 脚本 代码 1 
JavaScript 脚本 代码 2 


«/Script» 
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虽然 本 书 的 主要 内 容 是 讲解 Android 网 络 应 用 开发 的 知识 ， 但 是 为 了 让 读者 更 加 深入 
地 了 解 每 一 个 网 络 领域 的 具体 原理 ， 需 要 讲解 一 些 底层 和 内 核 方 面 的 知识 作为 补充 和 铺 
垫 ， 所 以 下 面 讲解 一 些 Android 内 核 源码 和 了 驱动 开发 方面 的 知识 。 


2.4.1 Android 继 承 于 Linux 


Android 是 在 Linux 2.6 的 内 核 基 础 之 上 运行 的 ， 提 供 的 核心 系统 服务 包括 安全 、 内 存 
管理 、 进 程 管理 、 网 络 组 和 驱动 模型 等 内 容 。 内 核 部 分 还 相当 于 一 个 介 于 硬件 层 和 系统 中 
其 他 软件 组 之 间 的 抽象 层次 。 但 是 严格 来 说 它 不 算是 Linux 操作 系统 。 
因为 Android 内 核 是 由 标准 的 Linux. 内 核 修改 而 来 的 ， 所 以 它 继承 了 Linux 内 核 的 诸 
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多 优点 ， 保 留 了 Linux 内 核 的 主体 架构 。 同 时 Android 按照 移动 设备 的 需求 ， 在 文件 系 
统 、 内 存 管理 、 进 程 间 通信 机 制 和 电源 管理 等 方面 进行 了 修改 ， 添 加 了 相关 的 驱动 程序 和 
必要 的 新 功能 。 但 是 和 其 他 精简 的 Linux 系统 相 比 ， 例 如 uClinux，Android 很 大 程度 上 保 
留 了 Linux 的 基本 架构 ， 因 此 Android 的 应 用 性 和 扩展 性 更 强 。 


2.4.2 ” Android 内 核 和 Linux 内 核 的 区 别 


Android 系统 的 系统 层面 的 底层 是 Linux， 并 且 在 中 间 加 上 了 一 个 叫 作 Dalvik 的 Java 
虚拟 机 ， 这 从 表面 层 看 是 Android 运行 库 。 每 个 Android 应 用 都 运行 在 自己 的 进程 上 ， 享 
有 Dalvik 虚拟 机 为 其 分 配 的 专 有 实例 。 为 了 支持 多 个 虚拟 机 在 同一 个 设备 上 高 效 运行 ， 
Dalvik 被 改写 过 。 

Dalvik 虚拟 机 执行 的 是 Dalvik 格式 的 可 执行 文件 (.dex)。 该 格式 经 过 优化 ， 以 降低 内 
存 耗 用 到 最 低 。Java 编译 器 将 Java 源 文件 转换 为 class 文件 ，class 文件 又 被 内 置 的 dx 工 
具 转 化 为 dex 格式 文件 ， 这 种 文件 在 Dalvik 虚拟 机 上 注册 并 运行 。 

Android 系统 的 应 用 软件 都 是 运行 在 Dalvik 之 上 的 Java 软件 ， 而 Dalvik 是 运行 在 
Linux 中 的 ， 在 一 些 底层 功能 ， 比 如 线程 和 低 内 存 管 理 方面 ，Dalvik 虚拟 机 是 依赖 Linux 
内 核 的 。 由 此 可 见 ，Android 是 运行 在 Linux 之 上 的 操作 系统 ， 但 是 它 本 身 不 能 算是 Linux 
的 某 个 版 本 。 

Android 内 核 和 Linux 内 核 的 差别 主要 体现 在 以 下 11 个 方面 。 

1) Android Binder 

Android Binder 是 基于 OpenBinder 框架 的 一 个 驱动 ， 用 于 提供 Android 平台 的 进程 间 
通信 (PC，Inter-Process Communication)。 原 来 的 Linux 系统 上 层 应 用 的 进程 间 通 信 主 要 是 
D-bus(desktop bus)， 采 用 消息 总 线 的 方式 来 进行 IPC。 

其 源 代码 位 于 : drivers/staging/android/binder.c. 

2) Android 电源 管理 (PM) 

Android 电源 管理 是 一 个 基于 标准 Linux 电源 管理 系统 的 轻 量 级 的 Android 电源 管理 驱 
动 ， 针 对 嵌入 式 设备 做 了 很 多 优化 。 利 用 锁 和 定时 器 来 切换 系统 状态 ， 控 制 设备 在 不 同 状 
态 下 的 功 耗 ， 以 达到 节能 的 目的 。 

其 源 代码 分 别 位 于 以 下 文件 : 


ū kemel/power/earlysuspend.c 


kernel/power/consoleearlysuspend.c 


口 
Q  kemel/power/fbearlysuspend.c 

Q  kemel/power/wakelock.c 

Q  kemel/power/userwakelock.c 

3) 低 内 存 管理 器 (Low Memory Killer) 

Android 中 的 低 内 存 管理 器 和 Linux 标准 的 OOM(Out Of Memory) 相 比 ， 其 机 制 更 加 灵 
活 ， 它 可 以 根据 需要 中 止 进程 来 释放 需要 的 内 存 。Low Memory Killer 的 代码 非常 简单 ， 里 
面 的 关键 是 函数 Lowmem _shrinker()。 作 为 一 个 模块 在 初始 化 时 调用 register_shrinke 注册 
Lowmem shrinker， 它 会 被 vm 在 内 存 紧 张 的 情况 下 调用 。Lowmem shrinker 完成 具体 操 
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作 ， 简 单 说 就 是 寻找 一 个 最 合适 的 进程 杀 死 ， 从 而 释放 它 占 用 的 内 存 。 

其 源 代码 位 于 : drivers/staging/android/lowmemorykiller.c 

4) 匿名 共享 内 存 (Ashmem) 

匿名 共享 内 存 为 进程 间 提 供 大 块 共享 内 存 ， 同 时 为 内 核 提供 回收 和 管理 这 个 内 存 的 机 
制 。 如 果 一 个 程序 尝试 访问 Kemel 释放 的 一 个 共享 内 存 块 ， 它 将 会 收 到 一 个 错误 提示 ， 然 
后 重新 分 配 内 存 并 重 载 数据 。 

其 源 代码 位 于 : mm/ashmem.c 

5) Android PMEM(Physical) 

PMEM 用 于 向 用 户 空间 提供 连续 的 物理 内 存 区 域 ，DSP 和 某 些 设备 只 能 工作 在 连续 的 
物理 内 存 上 。 了 驱动 中 提供 了 mmap、open、release 和 ioctl 等 接口 。 

源 代码 位 于 : drivers/misc/pmem.c 


6) Android Logger 

Android Logger 是 一 个 轻 量 级 的 日 志 设 备 ， 用 于 抓 取 Android 系统 的 各 种 日 志 ， 是 
Linux 所 没有 的 。 

其 源 代码 位 于 : drivers/staging/android/logger.c 

7) Android Alarm 


Android Alarm 提供 了 一 个 定时 器 用 于 把 设备 从 睡眠 状态 唤醒 ， 同 时 它 也 提供 了 一 个 即 
使 在 设备 睡眠 时 也 会 运行 的 时 钟 基准 。 
其 源 代码 位 于 以 下 文件 : 


Q drivers/rtc/alarm.c 


Q drivers/rtc/alarm-dev.c 

8) USB Gadget 驱动 

此 驱动 是 一 个 基于 标准 Linux USB Gadget 驱动 框架 的 设备 驱动 ，Android 的 USB 驱动 
是 基于 Gadget 框架 的 。 

其 源 代码 位 于 以 下 文件 : 

Q drivers/usb/gadget/android.c 

Q drivers/usb/gadget/f adb.c 

Q drivers/usb/gadget/f mass storage.c 

9) Android RAM Console 

为 了 提供 调试 功能 ，Android 允许 将 调试 日 志 信息 写 入 一 个 被 称 为 RAM Console 的 设 
备 中 ， 它 是 一 个 基于 RAM 的 Buffer. 

其 源 代码 位 于 : drivers/staging/android/ram console.c 

10) Android timed device 

Android timed device 提供 了 对 设备 进行 定时 控制 的 功能 ， 目 前 仅仅 支持 vibrator 和 
LED 设备 。 

其 源 代码 位 于 : drivers/staging/android/timed output.c(timed gpio.c) 

11) Yaffs2 文件 系统 

在 Android 系统 中 ， 采 用 Yaffs2 作为 MTD NAND Flash 文件 系统 。Yaffs2 是 一 个 快速 
稳定 的 、 应 用 于 NAND 和 NOR Flash 的 跨 平 台 嵌 入 式 设备 文件 系统 ， 同 其 他 Flash 文件 系 
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统 相 比 ，Yaffs2 使 用 更 小 的 内 存 来 保存 它 的 运行 状态 ， 因 此 占用 内 存 小 ; Yaffs2 的 垃圾 回 
收 非常 简单 而 且 快 速 ， 因 此 能 达到 更 好 的 性 能 ，Yaffs2 在 大 容量 的 NAND Flash 上 性 能 表 
现 尤 为 明显 ， 非 常 适合 大 容量 的 Flash 存储 。 

其 源 代码 位 于 : fs/yaffs2/ 目 录 。 


25 简要 分 析 Android 源码 


源码 分 析 是 深入 掌握 Android 网 络 应 用 知识 的 前 提 工 作 ， 在 本 节 的 内 容 中 ， 将 讲解 分 
析 Android 源码 的 基本 知识 ， 为 读者 步 入 本 书后 面 知识 的 学 习 打 下 基础 。 


2.5.1 获取 并 编译 Android 源 码 
在 分 析 Android 源码 之 前 ， 需 要 先 下 载 获 取 Android 源码 。 读 者 可 以 登录 


http://source.android.com/ 获取 Android 的 源码 ， 在 网 页 http://source.android.com/source/ 
downloading.html 中 详细 介绍 了 获取 Android 源码 的 方法 ， 如 图 2-14 所 示 。 


open source project 


Downloading the Source Tree 

Installing Repo 

Repo is a too that makes it easier to work with GH in the context of Andicid For more infomation about Repo, see Version Contr 
To instal, mtatze and configure Repo, fellow those stops 


e Make sure you have a bn/ directory in your home directory, ard that i ia included in your path 


$ mkdir ~/bin 
$ PaTHe-/bin: $eATH 


Contributing 
Le cra Pain 
Banino Pide © Download the Repo script and ensure i is executable: 
Ufe afa Bug 
Reverting Buas § curl hetps: //androié. git.kernel.org/repo > ~/bin/repo 
5 chmod ax ~/bin/repo 


* The MDE checksum for repo is BoS9064-4419455047159505522008 
Using Edipse. Initializing a Repo client 
Coge She Gudelnes 

Mim ARer inataling Repo, set up your cien to access the android source repository. 


‘© Create an emoty directory to held your working fles 


图 2-14 Linux 下 获取 Android 源 码 的 方法 
在 下 载 源 码 时 ， 需 要 使 用 repo 或 git 工具 来 实现 。 下 面 将 详细 介绍 使 用 工具 获取 
Android 源码 的 流程 。 
(1) 创建 源 代码 下 载 目 录 ， 命 令 如 下 : 
mkdir /work/android-froyo-r2 
(2) 用 repo 工具 初始 化 一 个 版 本 ， 假 如 是 Android 2.2r2， 则 命令 如 下 : 


cd /work/android-froyo-r2 
repo init -u git://android.git.kernel.org/platform/manifest.git -b froyo 


在 初始 化 过 程 中 会 显示 相关 的 版 本 TAG 信息 ， 同 时 会 提示 我 们 输入 用 户 名 和 邮箱 地 
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址 ， 上 面 的 命令 初始 化 的 是 Android 2.2 froyo 的 最 新 版 本 。 
(3) 因为 Android 2.2 有 很 多 个 版 本 ， 这 些 版 本 信息 可 以 从 TAG 信息 中 看 出 来 。 目 前 


froyo 的 所 有 版 本 信息 如 下 : 
* [new tag] android-2.2.1 rl -> android-2.2.1 rl 
* [new tag] android-2.2 rl -> android-2.2 rl 
* [new tag] android-2.2 r1.1 -> android-2.2 r1.1 
* [new tag] android-2.2 r1.2 -» android-2.2 r1.2 
* [new tag] android-2.2 r1.3 -» android-2.2 r1.3 
* [new tag] android-cts-2.2 rl -» android-cts-2.2 r1 
* [new tag] android-cts-2.2 r2 -» android-cts-2.2 r2 
* [new tag] android-cts-2.2 r3 -» android-cts-2.2 r3 
每 次 下 载 的 都 是 最 新 的 版 本 ， 当 然 也 可 以 根据 TAG 信息 下 载 某 一 特定 的 版 本 。 例 如 
下 面 的 命令 : 


repo init -u git://android.git.kernel.org/platform/manifest.git -b 
android-cts-2.3 r1 


(4) 开始 下 载 源码 ， 命 令 如 下 : 


repo sync 


froyo 版 本 的 代码 很 大 ， 超 过 2GB， 下 载 过 程 非常 漫长 ， 需 要 读者 耐心 等 待 。 
(5) 编译 代码 ， 命 令 如 下 : 


cd /work/android-froyo-r2 
make 


EX repo 获取 的 方式 速度 非常 慢 ， 我 们 可 以 通过 网 页 浏览 的 方式 来 访问 Android 代码 
库 ， 其 浏览 路 径 是 http://android.git.kernel.org/， 界 面 如 图 2-15 所 示 。 


git clone git//endroid.gitkernel.org/ + project path. 
To clone the entire platform, install repo, and run: 


mkdir mydroid 

cd mydroid 

ropo init -u git//android.git.kerneL.org/platform/manifest.git 
repo sync 


For more information about git, see an overview the tutorial or the man pages 


projects / 335 git 
Seack[ 

Project. Description. Owner Last Change 

Al-Projectsqit reviewsource android.com.. Android Open Source.. No commits sma shaogo tee 
dovice/common.git Android Opon Source... 2 months ago saxmoisbotos | loa ee 
device/google/accessony/arduino.cit Android accessory support.. Android Open Source.. 2 months ago sm linenos iioa | ce 
device/coogle/accessory/demokit git Android accessory support.. Android Open Source.. 2 months ago zmen Izhonios Iioa | te 
device/tc/commor.git Files specficto HTC devices. Android Open Source... 9 months ago smman batis ica tet 
device /ntc/dream-sapphite.git Android Open Source.. 10 months ago zamen ates iisa | xee 
device/htc/dreamgit Files specific to HTC dream.. Android Open Source.. 10 months ago zanmen sexos ica | tee 


2-15 页面 浏览 方式 访问 Android 代 码 库 
每 注意 ; ”因为 上 述 获取 Android 源码 的 过 程 非常 缓慢 ， 所 以 一 般 建 议 不 要 使 用 repo 
来 下 载 Android 源码 ， 而 直接 登录 http//www.androidin.com/bbs/pub/ 
cupcake.targz 来 下 载 ， 解 压 出 来 的 cupcake 中 也 有 .repo 文件 夹 ， 此 时 可 以 通 
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it repo sync 来 更 新 cupcake 代码 。 命 令 如 下 : 


tar -xvf cupcake.tar.gz 


2.5.2 Android 对 Linux 的 改造 


Android 内 核 是 基于 Linux 2.6 内 核 的 ， 是 一 个 增强 的 内 核 版 本 ， 除 了 修改 部 分 Bug 
外 ， 还 提供 了 用 于 支持 Android 平台 的 设备 驱动 。Android 不 但 使 用 了 Linux 内 核 的 基本 功 
能 ， 而 且 对 Linux 进行 了 改造 ， 以 实现 更 为 强大 的 通信 功能 

Android 中 的 Linux 内 核 与 驱动 结构 如 图 2-16 所 示 。 


系统 调用 接口 (System Call) 

进程 调度 内 存 管理 网 络 
kernel mm net 

进程 通信 驱动 程序 | | 虚拟 系统 文件 VFS 
IPC driver 各 种 文件 系统 


图 2-16 Android 中 的 Linux 内 核 与 驱动 结构 
2.5.3 ”为 Android 构 建 Linux 的 操作 系统 


如 果 我 们 以 一 个 原始 的 Linux 操作 系统 为 基础 ， 改 造成 为 一 个 适合 于 Android 的 系 
me ME ee eae a 在 Android E 


以 下 三 个 步 又。 

(1). 编写 新 的 源 代码 。 

(2) 在 KConfig 配置 文件 中 增加 新 内 容 。 

(3) 在 Makefile 中 增加 新 内 容 。 

在 Android 系统 中 ， 通 常会 使 用 FrameBuffer 驱动 、Event 驱动 、Flash MTD 驱动 、 
Wi-Fi 驱动 、 蓝 牙 驱 动 和 串口 等 驱动 程序 。 并 且 还 需要 音频 、 视 频 、 传 感 器 等 驱动 和 sysfs 
接口 。 移 植 的 过 程 就 是 移植 上 述 驱 动 的 过 程 ， 我 们 的 工作 是 在 Lins 下 开发 适用 于 
Android 的 驱动 程序 ， 并 移植 到 Android 系统 。 

在 Android 中 添加 扩展 驱动 程序 的 基本 步骤 如 下 。 

(1) 在 Linux 内 核 中 移植 硬件 驱动 程序 ， 实 现 系统 调用 接口 。 
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(2) 把 硬件 驱动 程序 的 调用 在 HAL 中 封装 成 Stub。 
(3) 为 上 层 应 用 的 服务 实现 本 地 库 ， 由 Dalvik 虚拟 机 调用 本 地 库 来 完成 上 层 Java 代码 
的 实现 。 
(4) 编写 Android 应 用 程序 ， 提 供 Android 应 用 服务 和 用 户 操作 界面 。 


2.6 总 结 和 网 络 应 用 有 关 的 包 


在 Android 系统 中 开发 网 络 项 目 时 ， 需 要 用 到 Android SDK 中 为 我 们 提供 的 包 ， 这 些 
包 的 具体 说 明 如 表 2-2 所 示 。 


表 2-2 Android SDK 中 和 网 络 有 关 的 包 


包 说 明 
提供 与 联网 有 关 的 类 ， 包 括 流 和 数据 包 (datagram)sockets、Internet 协议 和 常 
java.net 见 HTTP 处 理 。 该 包 是 一 个 多 功能 网 络 资源 。 有 经 验 的 Java 开发 人 员 可 
以 立即 使 用 这 个 熟悉 的 包 创建 应 用 程序 

虽然 没有 提供 显 式 的 联网 功能 ， 但 是 仍然 非常 重要 。 该 包 中 的 类 由 其 他 


java.io Java 包 中 提供 的 socket 和 连接 使 用 。 它 们 还 用 于 与 本 地 文件 (在 与 网 络 进 
行 交互 时 会 经 常 出 现 ) 的 交互 
; i 包含 表示 特定 数据 类 型 的 缓冲 区 的 类 。 适 用 于 两 个 基于 Java 语言 端点 之 间 
java.nio "e 
的 通信 


表示 许多 为 HTTP 通信 提供 精确 控制 和 功能 的 包 。 可 以 将 Apache 视 为 流 
org.apache. 

zu 行 的 开源 Web 服务 器 

除 核心 javanet* 类 以 外 ， 包 含 额外 的 网 络 访问 socket。 该 包 包括 URI 


€ 类 ， 后 者 频繁 用 于 Android 应 用 程序 开发 ， 而 不 仅仅 是 传统 的 联网 方面 
android.net.http 包含 处 理 SSL 证 书 的 类 

包含 在 Android 平台 上 管理 有 关 Wi-Fi(802.11 无 线 Ethemet) 所 有 方面 的 
android.net.wifi 类 。 并 不 是 所 有 设备 都 配备 了 Wi-Fi 功能 ， 特 别 是 Android 在 Motorola 和 


LG 等 手机 制造 商 的 “翻盖 手机 ”领域 获得 了 成 功 

包含 用 于 管理 和 发 送 SMS( 文 本 ) 消 息 的 类 。 一 段 时 间 后 ， 可 能 会 引入 额外 的 
android.telephony.gsm 包 来 为 非 GSM 网 络 提供 类 似 的 功能 ， 比 如 CDMA 2 android.telephony.cdma 
等 网 络 


W 


ae 在 Android 网 络 应 用 中 ， 通 常 是 用 HTTP 协议 来 传输 网 络 
C 数据 。 在 Android 平台 中 开发 HTTP 通信 处 理应 用 项 目 时 ， 需 


要 用 到 Java 中 的 网 络 通信 协议 。 在 本 章 的 内 容 中 ， 将 详细 讲解 
在 Android 系统 中 开发 HTTP 通信 项 目的 基本 知识 。 
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3.1 Java 中 的 网 络 通 信 基 础 


在 互联 网 快速 发 展 的 今天 ， 任 何 程序 都 难以 离开 网 络 ， 因 为 人 们 已 经 习惯 了 用 网 络 快 
速 传播 信息 。Java 提供 了 很 多 重要 的 协议 来 帮助 人 们 开发 网 络 项 目 ， 在 Android 系统 开发 
网 络 应 用 时 ， 需 要 用 到 Java 中 的 这 些 协 议 。 


3.1.4 _ Java 网络 通信 概述 


在 学 习 Java 网 络 通信 之 前 ， 读 者 一 定 要 弄 清楚 一 些 网 络 方面 的 专业 术语 ， 只 有 和 弄 懂 这 
些 知 识 点 ， 才 能 更 好 地 掌握 Java 网 络 编程 。 


1. TCP/IP 协 议 


TCP/IP 是 Transmission Control Protocol/Internet Protocol 的 简写 ， 中 文 译名 为 传输 控制 协 
议 /互联 网 络 协议 ， 是 Intemet 最 基本 的 协议 ， 简 单 地 说 ， 就 是 由 底层 的 卫 协 议和 TCP 协 议 组 
成 的 。 众 所 周知 ， 如 今 电脑 上 Intemet 都 要 作 TCP/P 协 议 设置 ， 显 然 该 协议 成 了 当今 地 球 村 
“人 与 人 ”之 间 的 “牵手 协议 ”。 

IP 协议 的 英文 译名 是 互联 网 络 协议 ， 从 这 个 名 称 就 可 以 知道 IP 协议 的 重要 性 。 在 现 
实生 活 中 ， 我 们 进行 货物 运输 时 都 要 把 货物 包装 成 一 个 个 的 纸箱 或 者 是 集装箱 之 后 才 进行 
运输 ， 在 网 络 世界 中 各 种 信息 也 是 通过 类 似 的 方式 进行 传输 的 。IP 协议 规定 了 数据 传输 时 
的 基本 单元 和 格式 。 如 果 比 作 货 物 运 输 ，IP 协议 规定 了 货物 打包 时 的 包装 箱 尺 寸 和 包装 的 
程序 。 除 了 这 些 以 外 ，IP 协议 还 定义 了 数据 包 的 递交 办 法 和 路 由 选择 。 同 样 用 货物 运输 做 
比喻 ，IP 协议 规定 了 货物 的 运输 方法 和 运输 路 线 。 

从 前 面 的 介绍 ， 读 者 可 能 已 经 知道 了 IP 协议 很 重要 ， 那 TCP 协议 是 做 什么 的 呢 ? 在 
IP 协议 中 定义 的 传输 是 单 向 的 ， 也 就 是 说 发 出 去 的 货物 对 方 有 没有 收 到 我 们 是 不 知道 的 ， 
就 好 像 8 毛 钱 一 份 的 平 信 一 样 。 那 对 于 重要 的 信件 我 们 要 寄 挂 号 信 该 怎么 办 呢 ? TCP 协议 
就 是 帮 我 们 寄 “ 挂 号 信 ” 的 。TCP 协议 提供 了 可 靠 的 面向 对 象 的 数据 流传 输 服务 的 规则 和 
约定 。 简 单 地 说 ， 在 TCP 模式 中 ， 对 方 发 一 个 数据 包 给 你 ， 你 要 发 一 个 确认 数据 包 给 对 
方 ， 通 过 这 种 确认 来 提供 可 靠 性 。 


2. 使 用 URL 进 行 网 络 链接 


URL 是 Uniform Resource Locator 的 缩写 ， 称 为 网 页 地 址 ， 是 Internet 上 标准 的 资源 的 
地 址 。 它 最 初 是 由 蒂 姆 。 伯 纳 斯 - 李 发 明 用 来 作为 万 维 网 的 地 址 的 。 它 已 经 被 万 维 网 联盟 
编制 为 因特网 标准 RFC1738 了 。 它 是 用 于 完整 地 描述 Internet 上 网 页 和 其 他 资源 的 地 址 的 
一 种 标识 方法 。 

Intenet 上 的 每 一 个 网 页 都 具有 一 个 唯一 的 名 称 标识 ， 通 常 称 之 为 URL 地 址 ， 这 种 地 
址 可 以 是 本 地 磁盘 ， 也 可 以 是 局 域 网 上 的 某 一 台 计算 机 ， 更 多 的 是 Intemet 上 的 站 点 。 简 
单 地 说 ，URL 就 是 Web 地址， 俗称 “网 址 ”。 
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Socket 和 ServerSocket 


在 本 节 的 学 习 中 ， 用 户 将 会 学 习 网 络 编程 的 初步 知识 。 网 络 编程 可 以 分 为 创建 


Socket、 


打开 连接 Socket 的 输入 流 和 输出 流 ， 对 Socket 进行 编程 ， 关 闭 Socket。 


1. 创建 Socket 
一 个 功能 齐全 的 Socket 的 工作 过 程 包含 以 下 四 个 基本 步骤 。 


a) 
Q) 
(3) 
(4) 


创建 Socket. 

打开 连接 到 Socket 的 输入 /输出 流 。 

按照 一 定 的 协议 对 Socket 进行 读 / 写 操作 。 

关闭 Socket。 在 实际 应 用 中 ， 并 未 使 用 到 显示 的 close， 虽 然 很 多 文章 都 推荐 如 


此 ， 不 过 在 简单 的 程序 中 ， 可 能 因为 程序 本 身 比较 简单 ， 所 以 无 须 使 用 close. 
在 Java.net 包 中 ， 定 义 了 Socket 和 ServerSocket 两 个 类 ， 类 Socket 表示 客户 端 或 者 服 
务 器 Socket 连接 的 两 端 ， 类 Socket 中 的 构造 方法 如 下 。 


a 


[| D 


Socket(inetAddress address,int port) 

Socket(inetAddress address,int port,boolean stream) 

Socket(String host,int port) 

Socket(String host,int port,boolean stream) 

Socket(SocketImp imp1) 

Socket(String host, int port inetAddress localAddr.int localport) 
Socket(inetAddress address,int port, inetAddreess localAddr.int localport) 


参数 address 表示 IP 地 址 ，host 表示 主机 名 ，port 表示 端口 号 ，stream 用 于 指明 
Socket 是 流 还 是 数据 报 ，localPort 表示 本 地 主机 的 端口 号 ，localAddr 是 本 地 及 其 地 址 ， 
impl 是 Socket 的 父 类 ， 在 SQLSocket 类 中 有 以 下 三 个 构造 方法 。 


口 
口 
口 
Hj 


ServerSocket(int port) 
ServerSocket(int port,int backlog) 
ServerSocket(int port,int backlog,InetAddress bindAddr) 


Soc 


参数 bindAddr 表示 本 机 地 址 。 
ket 和 ServerSocket 类 库 位 于 java.net 包 中 。ServerSocket 用 于 服务 器 端 ，Socket 是 


建立 网 络 连接 时 使 用 的 。 在 连接 成 功 时 ， 应 用 程序 两 端 都 会 产生 一 个 Socket 实例 ， 操 作 这 


个 实例 ， 


完成 所 需 的 会 话 。 对 于 一 个 网 络 连接 来 说 ， 套 接 字 是 平等 的 ， 并 没有 差别 ， 不 因 


为 在 服务 器 端 或 在 客户 端 而 产生 不 同 级 别 。 不 管 是 Socket 还 是 ServerSocket， 它 们 的 工作 
都 是 通过 SocketImpl 类 及 其 子 类 完成 的 。 

java.net.Socket 继承 于 java.lang.Object， 有 八 个 构造 器 ， 其 方法 并 不 多 ， 下 面 介 绍 使 用 
最 频繁 的 三 个 方法 ， 其 他 方法 大 家 可 以 参考 JDK 文档 。 


口 


Accept 方法 : 用 于 产生 “阻塞 ”， 直 到 接收 到 一 个 连接 ， 并 且 返 回 一 个 客户 端的 
Socket 对 象 实例 。 “阻塞 ”是 一 个 术语 ， 它 使 程序 运行 暂时 “停留 ”在 这 个 地 
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方 ， 直 到 一 个 会 话 产生 ， 然 后 程序 继续 执行 ， 通常“ 阻塞 ”是 由 循环 产生 的 。 
Q getInputStream 方法 : 获得 网 络 连接 输入 ， 同 时 返回 一 个 IutputStream 对 象 实例 。 
Q getOutputStream 方法 : 连接 的 另 一 端 将 得 到 输入 ， 同 时 返回 一 个 OutputStream 对 
象 实例 。 
3% 注意 : ”其 中 getInputStream 和 getOutputStream 方法 均 会 产生 一 个 IOException， 它 必 
须 被 捕获 ， 因 为 它们 返回 的 流 对 象 通常 都 会 被 另 一 个 流 对 象 使 用 。 
下 面 通过 两 段 程序 来 讲解 Socket 的 用 法 ， 一 个 是 服务 器 端 程 序 ， 另 一 个 是 客户 端 程序 。 
x 例 | 功 能 源码 路 径 | 
下 载 路 径 :\daima\3\KeSocket.java 
TF 333842 aima 3 ServerSocketl java 


实例 3-1 | 演示 实现 客户 端 和 服务 器 端 通信 的 过 程 


客户 端 程序 KeSocket java 的 实现 代码 如 下 : 


import java.net.*; 
import java.io.*; 
public class KeSocket 
t 
public static void main(String args[]) 
t 
try 
t 
Socket s-new Socket ("127.0.0.1",2007); 
InputStream is-s.getInputStream(); 
OutputStream os-s.getOutputStream(); 
PrintStream ps-new PrintStream(os); 
ps.println ("hello"); 
DataInputStream dis-new DataInputStream(is); 
String request-dis.readLine(); 
System.out.println (request); 
s.close(); 
} 
catch (ConnectException e) 
{ 
System.-out .println ("异常 "+e); 
} 
catch (IOException ee) 
{ 
System.out .println ("异常 "+ee); 
} 
catch (Exception eee) 
t 
System.out.println ("异常 "+eee); 
} 
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服务 器 端 程序 ServerSocketl java 的 实现 代码 如 下 : 


import java.net.*; 
import java.io.*; 
public class ServerSocketl 
t 
public static void main(String args[]) 
{ 
try 
{ 
ServerSocket ss-new ServerSocket (2007); 
while (true) 
{ 
Socket s-ss.accept(); 
InputStream is=s.getInputStream() ; 
OutputStream os-s.getOutputStream(); 
DataInputStream dis=new DataInputStream (is); 
String request-dis.readLine(); 
System.out.println (request); 
PrintStream ps-new PrintStream(os); 
ps.println("Bye"); 
s.close(); 
ss.close(); 
) 
} 
catch (IOException e) 
{ 
System.out .println ("异常 "+e); 
} 
catch (Exception ee) 
{ 
System.out .println ("异常 "+ee); 


) 
先 执行 服务 器 端 程序 ， 执 行 效果 如 图 3-1 所 示 。 


| 区 问题 | @ Javadoc [© Declaration| 国 控制 6 52 anj 
全 终止 KeSocket [Java 应 用 程序 ] C:\Program Files\ 局 其 % |B EE] -TB-ri- 


S% java.net.ConnectException: Connection timed out: connect 


图 3-1 服务 器 端 执行 结果 
执行 客户 端 程序 ， 执 行 效果 如 图 3-2 所 示 。 


- Andieid sss ainsi 


[区 FARE | @ Javadoc [© Declaration ERE © EX 
SERIE) KeSocket [Tava 应 用 程序 ] CiMProgran Files 下 其 演 C BE gG "eRe 


Bye 


图 3-2 客户 端 执行 的 程序 
2. 多 客户 连接 


在 实际 的 应 用 中 ， 往 往 有 许多 客户 端 向 服务 器 发 送 请 求 ， 服 务 器 端 会 启动 一 个 专门 的 
服务 线程 来 响应 客户 端的 请 求 ， 同 时 服务 器 本 身 在 启动 线程 之 后 ， 马 上 进入 监听 状态 。 下 
面 通过 一 段 代 码 讲解 多 客户 请 求 服务 器 的 程序 ， 服 务 器 端 程序 如 下 。 


源码 路 径 


演示 多 客户 请 求 服务 器 的 过 程 
实例 文件 DuoServer java 的 主要 代码 如 下 : 


import java.net.*; 
import java.io.*; 
public class DuoServer 


t 
public static void main(String args[]) 
t 
boolean connected-true; 
try 
t 
ServerSocket ss-new ServerSocket (2007); 
int clientnum-0; 
while (connected) 
{ 
ServerThread st=new ServerThread(ss.accept (),clientnum) ; 
st.start (); 
clientnum++; 
System.out.println(clientnum); 
} 
} 
catch (Exception e) 
{ 
System-out .println ("异常 "+e); 
} 
} 
} 


class ServerThread extends Thread 
{ 
private Socket s; 
int clientnum; 
public ServerThread(Socket s,int num) 
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this.s-s; 
clientnum=num+1; 


) 
public void run() 
{ 
try 
{ 
InputStream is=s.getInputStream() ; 
OutputStream os=s.getOutputStream() ; 
DataInputStream dis=new DataInputStream (is); 
String request-dis.readLine(); 
System.out.println (request); 
PrintStream ps-new PrintStream(os); 
ps.println ("Bye"); 
s.close(); 
} 
catch (Exception e) 
{ 
System.out.println ("异常 "+e); 
} 
} 
} 
运行 本 实例 程序 ， 然 后 运行 上 一 节 的 客户 端 
所 示 的 结果 。 
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时 序 的 代码 ， 调 用 7 次 后 就 会 看 到 如 图 3-3 


| 区 问题 | @ Javadoc | [È Declaration| 园 控制 和 22 
DuoServer [Java 应 用 程序 ] C:\Program Files\Java\jre! gg 


* 全 HES) ct B- 


EI 
we? 


33 多 客户 连接 


3.1.3. 网络 通信 的 综合 应 用 


经 过 前 面 内 容 的 学 习 ， 我 们 了 解 了 Java 技术 中 实现 网 络 通信 的 基本 知识 。 下 面 将 通过 


一 个 具体 实例 的 实现 过 程 ， 讲 解 实现 客户 端 和 服务 器 端 通信 的 流程 。 


"p 


头 


例 


源码 路 径 
下 载 路 径 :\daima\3\client.java 
下 载 路 径 :\daima\3\Serverjava 
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import java.io.*; 

import java.awt.*; 
import java.awt.event.*; 
import javax.swing.*; 
import java.net.*; 
import java.util.*; 


class Conn extends Thread( 
private JTextArea txt; 
private Socket st; 
private String msg - null; 
private BufferedReader br - null; 
private PrintStream ps; 
public Conn(Socket st,JTextArea txt) { 
Ebis.sE = st; 
this.txt = txt; 
start (); 
} 
public void run(){ 
try{ 
br = new BufferedReader (new InputStreamReader (new DataInputStream 
(st.getInputStream()))); 
ps = new PrintStream(new DataOutputStream(st.getOutputStream())); 
}catch (Exception e) { 
System.err.println("input failed"); 
} 
while (true) { 
try{ 
msg = br.readLine(); 
txt.append ("从 客户 端 收 到 信息 "+msg+'\n'); 
Server.send (msg) ; 
}catch (Exception e) { 
System.err.println ("connection closed"); 
break; 


public void send(String msg) { 
ps.println (msg); 
} 
E 
public class Server extends JFrame( 
private JTextArea txt; 
private ServerSocket ss; 
private static java.util.List«Conn» conns = new ArrayList<Conn>(); 
public Server (){ 
txt-new JTextArea(); 
this.setTitle ("服务 器 "); 
this.setLayout (new BorderLayout ()); 
this.add(new JScrollPane (txt),BorderLayout.CENTER); 


) 


0B 第 3 章 


this.setSize (500,300); 
this.setVisible (true); 
run(); 
} 
public void run(){ 
try{ 
ss = new ServerSocket (8000); 
}catch (Exception e) { 
System.err.println("open socket failed"); 
} 
txt. append ("信息 接收 时 间 是 :"+new Date ()+"\n"); 
while (true) { 
try{ 
Socket st-ss.accept(); 
conns.add(new Conn(st,txt)); 
$ 
catch (IOException ex) { 
System.err.println (ex); 


public static void send(String msg) { 
for(Conn c:conns) 
c.send(msg); } 
public static void main(String args[]){ 
Server myserver=new Server (); 


客户 端的 实现 文件 是 clientjava， 主 要 代码 如 下 : 


import java.io.*; 

import java.awt.*; 
import java.awt.event.*; 
import javax.swing.*; 
import java.net.*; 
import java.util.*; 


public 


t 


final JTextArea txta; 

JTextField txtf; 

JPanel pl; 

JButton bt; 

BufferedReader br; 

DataOutputStream out; 

PrintStream ps; 

Container f-this.getContentPane(); 
public Client ()( 
f.setLayout (new BorderLayout ()); 
txta-new JTextArea(); 
f.add(txta,BorderLayout.CENTER); 
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class Client extends JFrame implements ActionListener 
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txtf-new JTextField(20); 
bt-new JButton ("Rik") ; 
pl=new JPanel(); 
pl.setLayout (new FlowLayout ()); 
pl.add(txtf); 
pl.add(bt); 
bt.addActionListener (this); 
f.add (pl,BorderLayout.SOUTH); 
setTitle (" 信 息 发 送 端 ") ; 
setSize(500,300); 
setVisible (true); 
run(); 
new Thread (){ 
{start ();} 
public void run() { 
while (true) { 
try{ 
txta.append (" 收 到 消息 : "+br.readLine()+"\n"); 
}catch (Exception ex) {} 


) 


public void actionPerformed (ActionEvent e) { 
if(e.getSource()--bt)( 
String msg=txtf.getText (); 
try{ 
ps.println (msg); 
txta.append ("已 经 发 送 消息 :"+msg+"\n"); 
} 
catch (Exception ex) { 
txta.append (ex.toString()+'\n'); } 


public void run() { 
try{ 
Socket sc=new Socket ("127.0.0.1", 8000); 
out=new DataOutputStream(sc.getOutputStream()); 
ps = new PrintStream (out) ; 
br = new BufferedReader (new InputStreamReader 
(new DataInputStream(sc.getInputStream()))); 
} 
catch (IOException ex) { 
txta.append(ex.toString()+'\n"'); 
H 
public static void main(String args[]) { 
Client myclient-new Client(); 


i 
在 调试 时 ， 需 要 先 执行 客户 端 程序 Serverjava， 执 行 效果 如 图 3-4 所 示 。 然 后 执行 服 
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务 器 端 程序 clientjava， 执 行 效果 如 图 3-5 所 示 。 


经 发 送 消息 这 是 一 个 简单 的 Socskt 程 序 
你 到 消息 : 这 是 一 个 简单 的 Socskt 程 序 


息 接收 时 间 是 Tue Feb 17 15:44:57 CST 2009 


图 3-5 ”服务 器 端 程序 


3.2 HTTP 协议 


HTTP 意 为 超 文本 传输 协议 ， 是 HyperText Transfer Protocol 的 缩写 ， 是 互联 网 上 应 用 
最 为 广泛 的 一 种 网 络 协议 ， 所 有 的 WWW 文件 都 必须 遵守 这 个 标准 。 设 计 HTTP 的 最 初 目 
的 是 为 了 提供 一 种 发 布 和 接收 HTML 页 面 的 方法 。 在 本 节 将 简要 介绍 HTTP 技术 的 相关 基 
本 理论 知识 ， 为 读者 步 入 本 书后 面 知识 的 学 习 打 下 基础 。 


3.2.1 HTTP 概述 


HTTP 是 一 个 客户 端 和 服务 器 端 请 求 和 应 答 的 标准 (TCP)。 客 户 端 是 终端 用 户 ， 服 务 器 
端 是 网 站 。 通 过 使 用 Web 浏览 器 、 网 络 爬 虫 或 者 其 他 工具 ， 客 户 端 发 起 一 个 到 服务 器 上 指 
定 端口 (默认 端口 为 80) 的 HTTP 请 求 。 我 们 称 这 个 客户 端 为 用 户 代理 (User Agent)。 应 答 的 
服务 器 上 存储 着 (一 些 ) 资 源 ， 比 如 HTML 文件 和 图 像 ， 我 们 称 这 个 应 答 服 务 器 为 源 服务 器 
(Origin ServeD。 在 用 户 代理 和 源 服务 器 中 间 可 能 存在 多 个 中 间 层 ， 比 如 代理 、 网 关 或 者 隧 
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3É(tunnels). JS TCP/IP 协议 是 互联 网 上 最 流行 的 应 用 ，HTTP 协议 并 没有 规定 必须 使 用 
它 和 (基于 ) 它 支持 的 层 。 事 实 上 ，HTTP 可 以 在 任何 其 他 互联 网 协议 上 ， 或 者 在 其 他 网 络 上 
实现 。HTTP 只 假定 (其 下 层 协 议 提供 ) 可 靠 的 传输 ， 任 何 能 够 提供 这 种 保证 的 协议 都 可 以 被 
其 使 用 。 

通常 ， 由 HTTP 客户 端 发 起 一 个 请 求 ， 建 立 一 个 到 服务 器 指定 端口 (默认 是 80 端口 ) 的 
TCP 连接 。HTTP 服务 器 则 在 那个 端口 监听 客户 端 发 送 过 来 的 请 求 。 一 旦 收 到 请 求 ， 服 务 
器 (向 客户 端 ) 发 回 一 个 状态 行 ， 比 如 “HTTP/1.1 200 OK”， 和 响应 的 消息 ， 消 息 的 消息 体 
可 能 是 请 求 的 文件 、 错 误 消 息 或 者 其 他 一 些 信息 。 

HTTP 使 用 TCP 而 不 是 UDP 的 原因 在 于 (打开 ) 一 个 网 页 必须 传送 很 多 数据 ， 而 TCP 
协议 提供 传输 控制 ， 按 顺序 组 织 数据 和 进行 错误 纠正 。 


3.2.2 ”协议 功能 


HTTP 是 超 文本 传输 协议 ， 是 客户 端 浏览 器 或 其 他 程序 与 Web 服务 器 之 间 的 应 用 层 通 
信 协 议 。 在 Internet 上 的 Web 服务 器 上 存放 的 都 是 超 文本 信息 ， 客 户 机 需要 通过 HTTP 协 
议 传输 所 要 访问 的 超 文本 信息 。HTTP 包含 命令 和 传输 信息 ， 不 仅 可 用 于 Web 访问 ， 也 可 
以 用 于 其 他 因特网 /内 联网 应 用 系统 之 间 的 通信 ， 从 而 实现 各 类 应 用 资源 超 媒 体 访 问 的 
集成 。 

当 我 们 想 浏览 一 个 网 站 的 时 候 ， 只 需 在 浏览 器 的 地 址 栏 里 输入 网 站 的 地 址 就 可 以 了 ， 
例如 ，www.*****.com， 但 是 在 浏览 器 的 地 址 栏 里面 出 现 的 却 是 ，http:/www.******#*， 读 
者 知道 为 什么 会 多 出 一 个 “http” 吗 ? 

我 们 在 浏览 器 的 地 址 栏 里 输入 的 网 站 地 址 叫 作 URL(Uniform Resource Locator， 统 一 资 
源 定位 符 )。 就 像 每 家 每 户 都 有 一 个 门牌 地 址 一 样 ， 每 个 网 页 也 都 有 一 个 Internet 地 址 。 当 
在 浏览 器 的 地 址 栏 中 输入 一 个 URL 或 是 单 击 一 个 超级 链接 时 ，URL 就 确定 了 要 浏览 的 地 
址 。 浏 览 器 通过 超 文 本 传输 协议 (HTTP) 将 Web 服务 器 上 站 点 的 网 页 代码 提取 出 来 ， 并 翻 
译 成 漂亮 的 网 页 。 因 此 ， 在 我 们 认识 HTTP 之 前 ， 有 必要 先 弄 清楚 URL 的 组 成 。 例 如 ， 
http://www.**** com /china/index.htm 的 含义 如 下 。 

Q http//: 代表 超 文本 转移 协议 ， 通 知 ****.com 服务 器 显示 Web 页 ， 通 常 不 用 输入 。 

口 www: 代表 一 个 Web( 万 维 网 ) 服 务 器 。 

Q ****.com/:; 这 是 装 有 网 页 的 服务 器 的 域名 或 站 点 服务 器 的 名 称 。 

Q china 为 该 服务 器 上 的 子 目 录 ， 就 好 像 我 们 的 文件 夹 。 

Q index.htm: 是 文件 夹 中 的 一 个 HTML 文件 (网 页 )。 

众所周知 ，Internet 的 基本 协议 是 TCP/IP 协议 ， 然 而 在 TCP/IP 模型 最 上 层 的 是 应 用 层 
(Application layer)， 它 包含 所 有 高 层 的 协议 。 高 层 协议 有 : 文件 传输 协议 FTP、 电 子 邮 件 
传输 协议 SMTP、 域 名 系统 服务 DNS、 网 络 新 闻 传输 协议 NNTP 和 HTTP 协议 等 。 

HTTP 协议 (HyperText Transfer Protocol， 超 文本 传输 协议 ) 是 用 于 从 WWW 服务 器 传输 
超 文本 到 本 地 浏览 器 的 传输 协议 。 它 可 以 使 浏览 器 更 加 高 效 ， 使 网 络 传输 减少 。 它 不 仅 保 
证 计算 机 正确 快速 地 传输 超 文本 文档 ， 还 确定 传输 文档 中 的 哪 一 部 分 ， 以 及 哪 部 分 内 容 首 
先 显 示 ( 如 文本 先 于 图 形 ) 等 。 这 就 是 为 什么 在 浏览 器 中 看 到 的 网 页 地 址 都 是 以 “http:/” 开 
头 的 原因 。 
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3.2.3 Android 中 的 HTTP 


在 Android 系统 中 ， 提 供 了 以 下 三 种 通信 接口 。 

口 ”标准 Java 接口 : java.net。 

ū Apache 接口 : org.apache.http。 

OQ Android 网 络 接口 : android.net.http。 

网 络 编程 在 无 线 应 用 程序 开发 过 程 中 起 到 了 重要 的 作用 。 在 Android 系统 中 包括 
Apache HttpClient 库 ， 此 库 为 执行 Android 中 的 网 络 操作 之 首选 方法 。 除 此 之 外 ，Android 
还 可 允许 通过 标准 的 Java 联网 APIGava.net 包 ) 来 访问 网 络 。 即 便 使 用 Javanet 包 ， 也 是 在 
内 部 使 用 该 Apache 库 。 

为 了 访问 互联 网 ， 需 要 设置 应 用 程序 获取 android.permission.INTERNET 权限 的 许可 在 
Android 系统 中 ， 存 在 如 下 与 网 络 连接 相关 的 包 。 

1) java.net 

该 包 提供 联网 相关 的 类 ， 包 括 流 和 数据 报 套 接 字 、 互 联网 协议 以 及 通用 的 HTTP 处 
理 。 此 为 多 用 途 的 联网 资源 。 经 验 丰 富 的 Java 开发 人 员 可 立即 使 用 此 惯用 的 包 来 创建 应 用 
程序 。 

2) java.io 

尽管 未 明确 联网 ， 但 其 仍然 非常 重要 。 此 包 中 的 各 种 类 通过 其 他 Java 包 中 提供 的 套 接 
字 和 链接 来 使 用 。 它 们 也 可 用 来 与 本 地 文件 进行 交互 (与 网 络 进行 交互 时 经 常 发 生 )。 

3) java.nio 

该 包 包 含 表示 具体 数据 类 型 的 缓冲 的 各 种 类 。 便 于 基于 Java 语言 的 两 个 端点 之 间 的 网 
络 通信 。 

4) org.apache.* 

表示 可 为 进行 HTTP. 通信 提供 精细 控制 和 功能 的 各 种 包 。 可 将 Apache 识别 为 普通 的 
开源 Web 服务 器 。 

5) android.net 

该 包 包括 核心 java.net.* 类 之 外 的 各 种 附加 的 网 络 接 入 套 接 字 ， 包 括 URL 类 ， 其 通常 
在 传统 联网 之 外 的 Android 应 用 程序 开发 中 使 用 。 

6) android.net.http 

该 包 包含 可 操作 SSL 证 书 的 各 种 类 。 

7) android.net.wifi 

该 包 包含 可 管理 Android 平台 中 Wi-Fi(802.11 无 线 以 太 网 ) 所 有 方面 的 各 种 类 。 并 非 所 
有 的 设备 均 配 备 有 Wi-Fi 能 力 ， 尤 其 随 着 Android 在 对 制造 商 (如 诺基亚 和 LG) 手机 的 翻盖 
手机 研发 方面 取得 了 进展 。 

8) android.telephony.gsm 

该 包 包含 管理 和 发 送 短信 (文本 ) 消 息 所 要 求 的 各 种 类 。 随 着 时 间 的 推移 ， 可 能 将 引入 
一 种 附加 的 包 ， 以 提供 有 关 非 GSM 网 络 (如 CDMA 或 类 似 android.telephony.cdma) 的 类 似 
功能 。 
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3.8 18H) Apache 接口 


Apache HttpClient 是 一 个 开源 项 目 ， 弥 补 了 java.net.* 灵活 性 不 足 的 缺点 ， 为 客户 端 
的 HTTP 编程 提供 高 效 、 最 新 、 功 能 丰富 的 工具 包 支 持 。Android 平台 引入 了 Apache 
HttpClient 的 同时 还 提供 了 对 它 的 一 些 封装 和 扩展 ， 例 如 设置 默认 的 HTTP 超时 和 缓存 大 
小 等 。 早 期 的 Android 还 同时 包括 Commons HttpClient(org.apache.commons.httpclient.*) 
和 HttpComponents (org.apache.http.client.*), [47g E Android 平台 中 ， 使 用 得 最 多 的 是 
Apache 接口 。 本 节 将 详细 介绍 使 用 Apache 接口 (org.apache.http) 实 现 和 网 络 连接 的 基本 知 
识 ， 和 希望 读者 结合 演示 代码 深入 理解 每 一 个 知识 点 ， 做 到 学 以 致 用 。 


3.3.1 _ Apache 接口 基础 


在 Apache HttpClient 库 中 ， 以 下 内 容 是 对 网 络 连接 有 用 的 各 种 包 。 

Q  org.apache.http.HttpResponse 

org.apache.http.client.HttpClient 

org.apache.http.client.methods.HttpGet 
org.apache.http.impl.client.DefaultHttpClient 

HttpClient httpclient-new DefaultHttpClient(); 

如 果 想 从 服务 器 检索 此 信息 ， 则 需要 使 用 HttpGet 类 的 构造 器 ， 例 如 下 面 的 代码 : 


HttpGet request=new HttpGet ("http://innovator.samsungmobile.com"); 

然后 用 HttpClient 类 的 execute() 方 法 中 的 HttpGet 对 象 来 检索 HttpResponse 对 象 ， 例 
如 下 面 的 代码 : 

HttpResponse response = client.execute (request); 

接着 读 取 已 检索 的 响应 ， 例 如 下 面 的 代码 : 


BufferedReader rd = new BufferedReader 


OOOO 


(new 
InputStreamReader (response .getEntity() .getContent ())); 
String line = ""; 
while ((line = rd.readLine()) != null) { 


Log.d("output: ",line); 
5 


3.3.2 Apache 应 用 基础 


1. 连 网 流程 


在 Android 系统 中 ， 可 以 采用 HttpPost 和 HttpGet 来 封装 Post 请 求 和 Get 请 求 ， 然 后 
再 使 用 HttpClient 的 excute() 方 法 发 送 Post 或 者 Get 请 求 并 返回 服务 器 的 响应 数据 。 使 用 
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Apache 连 网 的 基本 流程 如 下 。 
(1) 设置 连接 和 读 取 超 时 时 间 ， 并 新 建 HttpClient 对 象 ， 例 如 下 面 的 代码 : 
// 设置 连接 超时 时 间 和 数据 读 取 超 时 时 间 


HttpParams httpParams = new BasicHttpParams(); 

HttpConnectionParams.setConnectionTimeout (httpParams, 
KeySource.CONNECTION TIMEOUT INT); 

HttpConnectionParams.setSoTimeout (httpParams, 
KeySource.SO TIMEOUT INT); 

// 新 建 HttpClient MR 

HttpClient httpClient = new DefaultHttpClient (httpParams) 


(2) 实现 Get 请 求 ， 例 如 下 面 的 代码 : 


// 获取 请 求 
HttpGet get = new HttpGet (url); 
// set HTTP head parameters 
//Map<String, String> headers 
if (headers != null) 
{ 
Set<String> setHead = headers.keySet (); 
Iterator<String> iteratorHead = setHead.iterator(); 
while (iteratorHead.hasNext ()) 
{ 
String headerName = iteratorHead.next (); 
String headerValue = (String) headers.get (headerName) ; 
MyLog.d(headerName, headerValue) ; 
get.setHeader (headerName, headerValue); 


// connect 
//need try catch 
response - httpClient.execute (get); 


(3) 实现 Post 发 送 请 求 处 理 ， 例 如 下 面 的 代码 : 


HttpPost post = new HttpPost (KeySource.HOST URL STR); 
// set HTTP head parameters 
Map<String, String» headers = heads; 
Set<String> setHead = headers.keySet (); 
Iterator<String> iteratorHead = setHead.iterator(); 
while (iteratorHead.hasNext () ) 
{ 
String headName = iteratorHead.next (); 
String headValue = (String) headers.get (headName) ; 
post .setHeader (headName, headValue) ; 
H 
/[** 
* 通常 的 HTTP 实体 需要 在 执行 上 下 文 的 时 候 动态 生成 的 。 
* HttpClient 的 提供 使 用 EntityTemplate 实体 类 和 contentProducer 
接口 支持 动态 实体 。 
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* 内 容 制作 是 通过 写 需求 的 内 容 到 一 个 输出 流 ， 每 次 请 求 的 时 候 都 会 产生 。 
* 因此 ， 通 过 EntityTemplate 创建 实体 通常 是 独立 的 ， 重 复 性 好 。 
if 
ContentProducer cp = new ContentProducer () 
{ 


public void writeTo (OutputStream outstream) 
throws IOException 
{ 
Writer writer = new OutputStreamWriter (outstream, 
"UTF-8"); 
writer.write (requestBody) ; 
writer.flush(); 
writer.close(); 
} 
n 
HttpEntity entity - new EntityTemplate (cp) ; 
post.setEntity (entity); 
} 
//connect , need try catch 
response = httpClient.execute (post) ; 


(4) 通过 Response 响应 请 求 ， 例 如 下 面 的 代码 : 


if (response.getStatusLine().getStatusCode() == 200) 
t 
/** 
* 因为 直接 调用 tostring 可 能 会 导致 某 些 中 文字 符 出 现 乱码 的 情况 。 所 以 此 处 使 用 
toByteArray 
* 如 果 需 要 转 成 String 对象， 可 以 先 调 用 EntityUtils.toByteArray () 方 法 将 
消息 实体 转 成 byte 数组 ， 
* 再 由 new String(byte[] bArray) 转换 成 字符 串 。 
ry 


byte[] bResultXml = EntityUtils.toByteArray (response 
.getEntity()); 
if (bResultXml != null) 
{ 
String strXml = new String(bResultXml, "utf-8"); 
} 
) 


这 样 ， 使 用 Apache 实现 连 网 处 理 数据 交互 的 过 程 就 完成 了 。 无 论 多 么 复杂 的 项 目 ， 
都 必须 遵循 上 面 的 流程 。 
2. HttpClient 网 络 通 信 


Apache 的 核心 功能 是 HttpClient， 与 网 络 有 关 的 功能 几乎 都 需要 用 HttpClient 实现 。 
因为 在 Android 开发 过 程 中 ， 经 常会 用 到 网 络 连 接 功能 与 服务 器 进行 数据 的 交互 ， 所 以 
Android 的 SDK 提供 了 Apache 的 HttpClient 来 方便 我 们 使 用 各 种 Http 服务 。 我 们 可 以 把 
HttpClient 想象 成 一 个 浏览 器 ， 通 过 它 的 API， 可 以 很 方便 地 发 出 Get 请 求 和 Post 请 求 。 

例如 只 需要 以 下 几 行 代码 就 能 发 出 一 个 简单 的 Get 请 求 并 打印 响应 结果 。 
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try ( 
// 创建 一 个 默认 的 Httpclient 
HttpClient httpclient = new DefaultHttpClient () ; 
// 创建 一 个 Get 请 求 
HttpGet request = new HttpGet ("www.google.com"); 
// 发 送 Get 请 求 ， 并 将 响应 内 容 转 换 成 字符 串 
String response = httpclient.execute(request, new 
BasicResponseHandler ()); 
Log.v("response text", response); 
) catch (ClientProtocolException e) ( 
e.printStackTrace(); 
) catch (IOException e) ( 
e.printStackTrace(); 
} 


有 读者 可 能 会 问 为 什么 上 述 代码 要 使 用 单 例 HttpClient Wa? 这 只 是 一 段 演示 代码 ， 实 
际 项 目 中 的 请 求 与 响应 处 理会 复杂 一 些 ， 并 且 还 要 考虑 到 代码 的 容错 性 ， 但 这 并 不 是 本 篇 
的 重点 。 读 者 重点 注意 代码 的 第 三 行 : 

HttpClient httpclient = new DefaultHttpClient (); 


在 发 出 HTTP 请 求 前 先 创 建 了 一 个 HttpClient 对 象 ， 而 在 实际 项 目 中 ， 我 们 很 可 能 会 在 多 
处 进行 HITP 通信 ， 这 时 候 不 需要 为 每 个 请 求 都 创建 一 个 新 的 HttpClient。 因 为 之 前 已 经 
提 到 ，HttpClient 就 像 一 个 小 型 的 浏览 器 ， 对 于 整个 应 用 ， 只 需要 一 个 HttpClient 就 够 了 。 
由 此 可 以 得 出 ， 使 用 简单 的 单 例 就 可 以 实现 ， 例 如 下 面 的 代码 : 
public class CustomerHttpClient ( 
private static HttpClient customerHttpClient; 


private CustomerHttpClient() ( 
} 


public static HttpClient getHttpClient() { 
if(null == customerHttpClient) { 
customerHttpClient = new DefaultHttpClient (); 


H 
return customerHttpClient; 


} 

但 是 如 果 同 时 有 多 个 请 求 需要 处 理 呢 ? 答案 是 使 用 多 线程 。 假 如 现在 应 用 程序 使 用 同 
一 个 HttpClient 来 管理 所 有 的 Http 请 求 ， 一 旦 出 现 并 发 请 求 ， 那 么 一 定 会 出 现 多 线程 的 问 
题 。 这 就 好 像 我 们 的 浏览 器 只 有 一 个 标签 页 却 有 多 个 用 户 ，A 要 上 Google, B 要 上 
baidu， 这 时 浏览 器 就 会 忙 不 过 来 。 幸 运 的 是 ，HttpClient 提供 了 创建 线程 安全 对 象 的 
API， 帮 助 我 们 很 快 地 得 到 线程 安全 的 “浏览 器 ”。 例 如 下 面 的 代码 很 好 地 解决 了 多 线程 
问题 : 

public class CustomerHttpClient { 

private static final String CHARSET = HTTP.UTF 8; 


private static HttpClient customerHttpClient; 
private CustomerHttpClient() { 
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} 
public static synchronized HttpClient getHttpClient() ( 
if (null == customerHttpClient) ( 
HttpParams params = new BasicHttpParams(); 
// 设置 一 些 基本 参数 
HttpProtocolParams.setVersion(params, HttpVersion.HTTP 1 1); 
HttpProtocolParams.setContentCharset (params, 

CHARSET) ; 
HttpProtocolParams.setUseExpectContinue (params, true); 
HttpProtocolParams.setUserAgent (params, 

"Mozilla/5.0(Linux;U;Android 3.0;en-us;Nexus One Build.FRG83) " 
+ "AppleWebKit/553.1(KHTML,like Gecko) Version/4.0 
Mobile Safari/533.1"); 
// 超时 设置 
/* 从 连接 池 中 取 连 接 的 超时 时 间 */ 
ConnManagerParams.setTimeout (params, 1000); 
/* 连接 超时 */ 
HttpConnectionParams.setConnectionTimeout (params, 2000); 
/* 请 求 超时 */ 
HttpConnectionParams.setSoTimeout (params, 4000); 
// 设置 我 们 的 Httpclient 支持 HTTP 和 HTTPS 两 种 模式 
SchemeRegistry schReg = new SchemeRegistry(); 
schReg.register(new Scheme("http", PlainSocketFactory 

-getSocketFactory(), 80)); 
schReg.register(new Scheme("https", SSLSocketFactory 

-getSocketFactory(), 443)); 

// 使 用 线程 安全 的 连接 管理 来 创建 Httpclient 
ClientConnectionManager conMgr = new 
ThreadSafeClientConnManager ( 
params, schReg); 
customerHttpClient = new DefaultHttpClient(conMgr, params); 


$ 
return customerHttpClient; 


} 


在 上 面 的 代码 中 ， 通 过 getHttpClient() 方 法 为 HttpClient 配置 了 一 些 基本 参数 和 超时 设 
置 ， 然 后 使 用 ThreadSafeClientConnManager 来 创建 线程 安全 的 HttpClient。 


3. HttpClient 网 络 编程 


下 面 来 介绍 使 用 Apache HttpClient 库 进 行 网 络 连接 的 过 程 ， 将 通过 一 段 具体 代码 的 实 
现 过 程 来 讲解 。 

(1) 在 文件 AndroidManifest.xml 中 添加 android.permission.INTERNET 权限 ， 这 样 才 可 
以 允许 应 用 程序 访问 网 络 。 具 体 代码 如 下 : 

«?xml version-"1.0" encoding-"utf-8"?» 

«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 


package-"com.apache" 
android:versionCode-"1" 


android:versionName-"1.0"» 
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«uses-sdk android:minSdkVersion-"8" /> 
«uses-permission android:name-"android.permission.INTERNET"»«/uses- 
permission» 
«application android:icon="@drawable/icon" 
android: label="@string/app name"? 
<activity android:name=".ApacheConnection" 
android: label="@string/app name"> 
<intent-filter> 
«action android:name-"android.intent.action.MAIN" /> 
«category android:name-"android.intent.category.LAUNCHER" /> 
«/intent-filter» 
</activity> 
</application> 
</manifest> 


(2) 使 用 activity“ApacheConnection” 来 创建 项 目 com.apache。 将 布局 文件 main.xml 
更 改 为 如 下 代码 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation-"vertical" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
ea 
«TextView 
android:text-"Enter URL" 
android: id="@+id/textViewl" 
android:layout width="wrap content" 
android:layout height="wrap content"> 
</TextView> 
<EditText 
android: id="@+id/editText1" 
android:layout width="match parent" 
android:text="http: //innovator.samsungmobile.com" 
android:layout height="wrap content"> 
</EditText> 
<Button 
android:text="Click Here" 
android: id="@+id/buttonl" 
android:layout width="wrap content" 
android:layout height="wrap content"> 
</Button> 
<EditText 
android: id="@+id/editText2" 
android:layout width="match parent" 
android:layout height="fill parent"> 
</EditText> 
</LinearLayout> 


(3) 编写 主 程序 文件 ApacheConnection java， 此 代码 将 能 允许 查看 HTML 代码 ， 具 体 
实现 代码 如 下 : 
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package com.apache; 
import java.io.BufferedReader; 
import java.io. InputStreamReader; 
import org.apache.http.HttpResponse; 
import org.apache.http.client.HttpClient; 
import org.apache.http.client.methods.HttpGet; 
import org.apache.http.impl.client.DefaultHttpClient; 
import android.app.Activity; 
import android.os.Bundle; 
import android.view.View; 
import android.view.View.OnClickListener; 
import android.widget.Button; 
import android.widget.TextView; 
public class ApacheConnection extends Activity ( 
Button bt; 
TextView textViewl; 
TextView textView2; 
/** Called when the activity is first created. */ 
@override 
public void onCreate (Bundle savedInstanceState) { 
super .onCreate (savedInstanceState); 
setContentView (R. layout .main) ; 
bt = (Button) findViewById(R.id.button1) ; 
textViewl = (TextView) findViewById(R.id.editTextl); 
textView2 = (TextView) findViewById(R.id.editText2) ; 
bt.setOnClickListener(new OnClickListener() { 
@override 
public void onClick(View v) { 
// TODO Auto-generated method stub 
textView2.setText (""); 
try { 
/*Apache HttpClient Library*/ 
HttpClient client = new DefaultHttpClient (); 
HttpGet request = new HttpGet (textViewl.getText ().toString()); 
HttpResponse response = client.execute (request); 
/* response code*/ 
BufferedReader rd - new BufferedReader( 
new InputStreamReader (response.getEntity().getContent ())); 
String line - ""; 
while ((line = rd.readLine()) != null) { 
textView2.append (line); 


} 
} catch (Exception exe) { 
exe.printStackTrace(); 
} 
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所 示 。 
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Apache Connection 


<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 
1.0 Transitional//EN" "http://Wwww.w3.org/TR/ 
xhtml 1/DTD/xhtml1-transitional.dtd"» «html 
j ww. W3.0rg/1999/xhtml" xml: 
en"»«head»«title» Samsung 
Mobile Innovator - Samsung Developer 
program for Windows Mobile&#44; Java and 
Android«/title»«link rel="shortcut icon" 
href-"http://innovator.samsungmobile.com/ 
LI "Image/Ico"/ 
tylesheet" hre 
samsungmobile.com/css/smi layout.cs: 
type="text/css” charset-"UTF-8" media="all"/ 
><link rel="stylesheet” hr 
samsungmobile.com/css/smi content wsg.css" 
type="text/css” charset-' media-"all"/ 
'/Innovator. 
samsungmobile.com/css/print.css" typez"text/ 
Css" charset-"UTF-8" media-' l- 
-2009.09.09 Ham MG--><link rel="stylesheet" 
href-"http://Innovator.samsungmobile.com/ 


图 3-6 执行 效果 
3.33 Apache 应 用 要 点 


Apache 中 的 HttpClient 是 一 个 完善 的 HTTP 客户 端 ， 它 提供 了 对 HTTP 协议 的 全 面 支 
持 ， 可 以 使 用 HTTP Get 方式 和 Post 方式 进行 访问 。 下 面 结合 实 例 ， 详 细 介绍 使 用 


HttpClient 的 方法 。 
(1) 新 建 一 个 http 项 目 ， 项 目 结构 如 图 3-7 所 示 。 
a ES http 
4 (9 src 
8 com.scott.http 
8 gen [G ated Java Files] 
4 @ test 


4 iB com.scott.http.test 
(2) HttpTestjava 

BA Android 3.0 

BA Referenced Libraries 

& assets 

& res 

cA AndroidManifest.xml 

B default.properties 


图 3-7 http 项 目 结构 
在 这 个 项 目 中 不 需要 任何 的 Activity， 所 有 的 操作 都 在 单元 测试 类 HttpTest.java 中 完成 。 
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Q) 因为 使 用 到 了 单元 测试 ， 所 以 在 这 里 先 介绍 如 何 配置 Android 中 的 单元 测试 。 所 
有 配置 信息 均 在 AndroidManifest xml 中 完成 ， 具 体 代码 如 下 : 


<?xml version-"1.0" encoding="utf-8"?> 
«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package-"com.scott.http" 
android:versionCode-"1" 
android:versionName-"1.0"» 
«application android:icon-"8drawable/icon" 
android: label="@string/app name"? 
<!-- 配置 测试 要 使 用 的 类 库 --> 
«uses-library android:name-"android.test.runner"/» 
«/application» 
<!-- 配置 测试 设备 的 主 类 和 目标 包 --> 
<instrumentation 
android:name-"android.test.InstrumentationTestRunner" 
android:targetPackage-"com.scott.http"/» 
<!-- 访问 HTTP 服务 所 需 的 网 络 权限 --> 
<uses-permission android:name="android.permission.INTERNET"/> 
<uses-sdk android:minSdkVersion-"1ll" /> 
</manifest> 


单元 测试 类 需要 继承 于 android.test.AndroidTestCase 类 ， 此 类 继承 于 
junit.framework.TestCase， 并 提供 了 getContext() 方 法 来 获取 Android. 上 下 文 环境 。 
(3) 编写 测试 文件 HttpTestjava， 具 体 代码 如 下 : 


package com.scot.http.test; 


import java.io.ByteArrayOutputStream; 
import java.io.InputStream; 

import java.util.ArrayList; 

import java.util.List; 


import junit.framework.Assert; 


import org.apache.http.HttpEntity; 

import org.apache.http.HttpResponse; 

import org.apache.http.HttpStatus; 

import org.apache.http.NameValuePair; 

import org.apache.http.client.HttpClient; 

import org.apache.http.client.entity.UrlEncodedFormEntity; 
import org.apache.http.client.methods.HttpGet; 

import org.apache.http.client.methods.HttpPost; 

import org.apache.http.entity.mime.MultipartEntity; 

import org.apache.http.entity.mime.content.InputStreamBody; 
import org.apache.http.entity.mime.content.StringBody; 
import org.apache.http.impl.client.DefaultHttpClient; 
import org.apache.http.message.BasicNameValuePair; 


import android.test.AndroidTestCase; 
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public class HttpTest extends AndroidTestCase { 
private static final String PATH = "http://192.168.1.57:8080/web"; 


public void testGet() throws Exception ( 

HttpClient client = new DefaultHttpClient (); 

HttpGet get = new HttpGet (PATH + 
"/TestServlet ?id=1001&name=j ohn&age=60") ; 

HttpResponse response = client.execute (get); 

if (response.getStatusLine().getStatusCode() == HttpStatus.SC OK) { 
InputStream is = response.getEntity().getContent(); 

String result = inStream?2String(is); 

Assert.assertEquals(result, "GET SUCCESS"); 


public void testPost() throws Exception ( 
HttpClient client = new DefaultHttpClient () ; 
HttpPost post = new HttpPost(PATH + "/TestServlet"); 
List«NameValuePair» params = new ArrayList<NameValuePair>(); 
params.add(new BasicNameValuePair("id", "1001")); 
params.add(new BasicNameValuePair("name", "john")); 
params.add(new BasicNameValuePair("age", "60")); 
HttpEntity formEntity = new UrlEncodedFormEntity (params); 
post.setEntity(formEntity) ; 
HttpResponse response = client.execute (post) ; 
if (response.getStatusLine().getStatusCode() == HttpStatus.SC OK) { 

InputStream is = response.getEntity() .getContent (); 

String result = inStream2String(is); 
Assert.assertEquals(result, "POST SUCCESS"); 


public void testUpload() throws Exception ( 
InputStream is = getContext ().getAssets().open("books.xml"); 
HttpClient client = new DefaultHttpClient (); 
HttpPost post = new HttpPost(PATH + "/UploadServlet"); 
InputStreamBody isb = new InputStreamBody(is, "books.xml"); 
MultipartEntity multipartEntity = new MultipartEntity(); 
multipartEntity.addPart("file", isb); 
multipartEntity.addPart ("desc", new StringBody("this is description.")); 
post.setEntity (multipartEntity); 
HttpResponse response - client.execute (post); 
if (response.getStatusLine().getStatusCode() == HttpStatus.SC OK) ( 

is = response.getEntity().getContent(); 

String result = inStream2String(is); 
Assert.assertEquals (result, "UPLOAD SUCCESS"); 

} 

} 


// 将 输入 流转 换 成 字符 串 
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private String inStream2String(InputStream is) throws Exception 
ByteArrayOutputStream baos = new ByteArrayOutputStream(); 
byte[] buf = new byte[1024]; 
int len = -1; 
while ((len = is.read(buf)) !- -1) { 
baos.write(buf, 0, len); 


) 
return new String (baos.toByteArray()):; 


} 

在 上 述 代 码 中 包含 了 三 个 测试 用 例 。 

O 在 定位 服务 器 地 址 时 使 用 到 了 耳 。 因 为 服务 端 是 在 Windows 上 运行 ， 这 里 不 能 用 
localhost， 而 本 单元 测试 运行 在 Android 平台 ， 如 果 使 用 localhost 就 意味 着 在 Android 内 前 
去 访问 服务 ， 可 能 会 访问 不 到 ， 所 以 必须 用 P 来 定位 服务 。 

@ testGet 测试 。 使 用 HttpGet 将 请 求 参数 直接 附 在 URL 后 面 ， 然 后 由 HttpClient 执 
行 Get 请 求 。 如 果 响 应 成 功 则 取得 响应 内 如 输入 流 ， 并 转换 成 字符 串 ， 最 后 判断 是 否 为 
GET SUCCESS. testGet 测试 对 应 的 服务 端 Servlet 代码 如 下 : 

GOverride 

protected void doGet (HttpServletRequest request, HttpServletResponse 
response) throws ServletException, IOException ( 
System.out.println("doGet method is called."); 
String id - request.getParameter ("id"); 
String name = request.getParameter ("name"); 
String age = request.getParameter ("age"); 
System.out.println("id:" + id + ", name:" + name + ", age:" + age); 
response.getWriter().write("GET SUCCESS"); 


} 


®© testPost 测试 。 在 此 使 用 HttpPost, URL 后 面 并 没有 附带 参数 信息 ， 参 数 信息 被 包 
装 成 一 个 由 NameValuePair 类 型 组 成 的 集合 形式 ， 然 后 经 过 UrlEncodedFormEntity 处 理 后 
调用 HttpPost 的 setEntity 方法 进行 参数 设置 ， 最 后 由 HttpClient 执行 。testPost 测试 对 应 的 
服务 端 代 码 如 下 : 


@override 

protected void doPost (HttpServletRequest request, 
HttpServletResponse response) throws ServletException, IOException { 
System.out.println("doPost method is called."); 
String id = request.getParameter ("id"); 
String name = request.getParameter ("name") ; 
String age = request.getParameter ("age") ; 
System.out.println("id:" + id +", name:" + name + ", age:" + age); 
response.getWriter() .write ("POST SUCCESS"); 

} 


上 面 的 两 段 代 码 是 最 基本 的 Get 请 求 和 Post 请 求 ， 参 数 都 是 文本 数据 类 型 ， 能 满足 普 
通 的 需求 ， 不 过 在 有 的 场合 (例如 要 用 到 上 传 文件 的 时 候 ) 却 不 能 使 用 基本 的 Get 请 求 和 
Post 请 求 了 ， 我 们 要 使 用 多 部 件 的 Post 请 求 。 下 面 介 绍 一 下 如 何 使 用 多 部 件 Post 操作 上 
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传 一 个 文件 到 服务 端 。 


HttpMime 开源 项 目 ， 该 组 件 是 专门 处 理 与 MIME 类 型 有 关 的 操作 。 


因为 Android 附带 的 HttpClient 版 本 暂 不 支持 多 部 件 Post 请 求 ， 所 以 需要 用 到 一 个 


因为 HttpMime 是 包含 


在 HttpComponents 项 目 中 的 ， 所 以 我 们 需要 去 Apache 官方 网 站 下 载 HttpComponents， 然 


后 把 其 中 的 HttpMime.jar 包 放 到 项 目 中 去 ， 如 图 3-8 所 示 。 


4 (S http 

4 下 src 

£8 com.scott.http 
es gen [Generated Java Files] 

4 @ test 

4 6B com.scothttp.test 
D) HttpTestjava 

BA Android 3.0 


4 


httpmime-4.1.1 jar - C:\Users\user' 
i asse 
& res 

回 AndroidManifest.xml 
default.properties 


图 3-8 添加 HttpMime.jar 包 


接 下 来 看 一 下 testUpload 中 的 测试 用 例 。 首 先 用 HttpMime 提供 的 InputStreamBody 处 


理 文件 流 参数 ， 然 后 用 StringBody 处 理 普通 文本 参数 ， 最 后 把 所 有 类 型 参数 都 加 入 到 一 个 


MultipartEntity 的 实例 中 ， 并 将 这 个 MultipartEntity 设置 为 此 次 Post 请 求 的 参数 实体 ， 然 后 


执行 Post 请 求 。 服 务 端 Servlet 代码 如 下 : 


package com.scott.web.servlet; 


import java.io.FileOutputStream; 
import java.io.IOException; 
import java.util.Iterator; 
import java.util.List; 


import javax.servlet.ServletException; 
import javax.servlet.http.HttpServlet; 
import javax.servlet.http.HttpServletRequest; 
import javax.servlet.http.HttpServletResponse; 


import org.apache.commons.fileupload.FileItem; 
import org.apache.commons.fileupload.FileItemFactory; 


import org.apache.commons.fileupload.FileUploadException; 
import org.apache.commons.fileupload.disk.DiskFileItemFactory; 
import org.apache.commons.fileupload.servlet.ServletFileUpload; 


@suppressWarnings ("serial") 
public class UploadServlet extends HttpServlet ( 
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@override 
@suppressWarnings ("rawtypes") 
protected void doPost (HttpServletRequest request, 
HttpServletResponse response) throws ServletException, IOException { 
boolean isMultipart = ServletFileUpload.isMultipartContent (request) ; 
if (isMultipart) { 
FileItemFactory factory = new DiskFileItemFactory(); 
ServletFileUpload upload = new ServletFileUpload (factory) ; 
try ( 
List items = upload.parseRequest (request) ; 
Iterator iter = items.iterator(); 
while (iter.hasNext()) { 
FileItem item = (FileItem) iter.next(); 
if (item.isFormField()) { 
// 普 通 文本 信息 处 理 
String paramName = item.getFieldName() ; 
String paramValue = item.getString(); 
System.out.println(paramName + ":" + paramValue); 
) else ( 
// 上 传 文件 信息 处 理 
String fileName = item.getName(); 
byte[] data = item.get(); 
String filePath = getServletContext ().getRealPath 
("/files") + "/" + fileName; 
FileOutputStream fos = new FileOutputStream(filePath) ; 
fos.write (data); 
fos.close(); 


) 
) 
) catch (FileUploadException e) ( 
e.printStackTrace(); 
) 
) 
response.getWriter().write("UPLOAD SUCCESS"); 


} 


这 样 ， 服 务 端 就 成 功 使 用 Apache 开源 项 目 FileUpload 实现 了 文件 上 传 处 理 。 在 使 用 
时 一 定 不 要 忘记 附加 commons-fileupload 和 commons-io 这 两 个 项 目的 jar 包 ， 对 服务 端 开 
发 不 太 熟 悉 的 朋友 可 以 到 网 上 查找 一 下 相关 资料 。 

介绍 完 上 面 的 三 种 不 同 的 情况 之 后 还 需要 考虑 一 个 问题 ， 在 实际 项 目 中 我 们 不 可 能 每 
次 都 新 建 HttpClient， 而 是 应 该 只 为 整个 应 用 创建 一 个 HttpClient， 这 样 就 可 以 将 其 用 于 所 
有 HTTP 通信 。 另 外 还 需要 注意 ， 在 通过 一 个 HttpClient 同时 发 出 多 个 请 求 时 可 能 会 引发 
多 线程 问题 。 针 对 上 述 两 个 问题 ， 需 要 优化 处 理 上 述 项 目 ， 优 化 处 理 过 程 如 下 。 

CD 扩展 系统 默认 的 Application， 并 将 其 应 用 在 项 目 中 。 

@ 使 用 HttpClient 类 库 提供 的 ThreadSafeClientManager 来 创建 和 管理 HttpClient。 优 
化 处 理 后 的 工程 文件 结构 如 图 3-9 所 示 。 


T 
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4 W& http 
4 @ src 

4 出 com.scott.http 
I) HttpActivityjava 
[加 MyApplicationjava, 

es gen [Generated Java Files] 

(9 test 

BA Android 3.0 

BA Referenced Libraries 

& assets 

& res 

ij AndroidManifest.xml 

default.properties 


$9 工程 文件 结构 
© 在 文件 MyApplication.java 中 扩展 了 系统 的 Application， 具 体 代码 如 下 : 


package com.scott.http; 


import org.apache.http.HttpVersion; 

import org.apache.http.client.HttpClient; 

import org.apache.http.conn.ClientConnectionManager; 
import org.apache.http.conn.scheme.PlainSocketFactory; 
import org.apache.http.conn.scheme.Scheme; 

import org.apache.http.conn.scheme.SchemeRegistry; 
import org.apache.http.conn.ssl.SSLSocketFactory; 
import org.apache.http.impl.client.DefaultHttpClient; 
import org.apache.http.impl.conn.tsccm.ThreadSafeClientConnManager; 
import org.apache.http.params.BasicHttpParams; 

import org.apache.http.params.HttpParams; 

import org.apache.http.params.HttpProtocolParams; 
import org.apache.http.protocol.HTTP; 


import android.app.Application; 

public class MyApplication extends Application ( 
private HttpClient httpClient; 
@override 
public void onCreate() { 


super.onCreate(); 
httpClient = this.createHttpClient (); 


@override 

public void onLowMemory() { 
super.onLowMemory () ; 
this.shutdownHttpClient (); 


> Andieid sssannsmia 


@override 

public void onTerminate() { 
super .onTerminate(); 
this.shutdownHttpClient (); 

} 


// 创 建 Httpclient 实例 
private HttpClient createHttpClient() { 
HttpParams params = new BasicHttpParams(); 
HttpProtocolParams.setVersion(params, HttpVersion.HTTP 1 1); 
HttpProtocolParams.setContentCharset (params, 
HTTP.DEFAULT CONTENT CHARSET); 
HttpProtocolParams.setUseExpectContinue(params, true); 


SchemeRegistry schReg - new SchemeRegistry(); 

schReg.register (new Scheme ("http", 
PlainSocketFactory.getSocketFactory(), 80)); 

schReg.register(new Scheme ("https", 
SSLSocketFactory.getSocketFactory(), 443)); 


ClientConnectionManager connMgr - new 
ThreadSafeClientConnManager (params, schReg); 


return new DefaultHttpClient (connMgr, params); 
) 


// 关 闭 连接 管理 器 并 释放 资源 
private void shutdownHttpClient() ( 
if (httpClient != null && httpClient.getConnectionManager() != null) { 
httpClient.getConnectionManager ().shutdown(); 


) 


// 对 外 提供 Httpclient 实例 
public HttpClient getHttpClient() ( 
return httpClient; 


} 


在 上 述 代码 中 重 写 了 方法 onCreate()， 在 系统 启动 时 就 创建 一 个 HttpClient， 重 写 了 
onLowMemory() 和 onTerminate() 方 法 ， 在 内 存 不 足 和 应 用 结束 时 关闭 连接 ， 释 放 资 源 。 需 
要 注意 的 是 ， 当 实例 化 DefaultHttpClient 时 ， 传 入 一 个 由 ThreadSafeClientConnManager 创 
建 的 ClientConnectionManager 实例 ， 负 责 管理 HttpClient 的 HITP 连接 。 

@ 在 文件 AndroidManifestxml 中 进行 如 下 配置 ， 目 的 是 让 “优化 ”版 的 Application 


«application android:name-".MyApplication" ...> 
</application> 
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如 果 不 进行 上 述 配置 ， 系 统 依旧 会 默认 使 用 android.app.Application。 在 添加 上 述 配置 
后 ， 系 统 就 会 使 用 前 面 编写 的 com.scotthttp.MyApplication， 然 后 就 可 以 在 context 中 调用 
getApplication() 来 获取 MyApplication 实例 。 

经 过 上 面 的 “优化 ”处 理 配 置 ， 接 下 来 就 可 以 在 活动 中 应 用 了 。 编 写 的 文件 
HttpActivity.java 的 实现 代码 如 下 : 


package com.scott.http; 


import 
import 


import 
import 
import 
import 


import 
import 
import 
import 
import 


java 
java 


-io.ByteArrayOutputStream; 
-io.InputStream; 


org.apache.http.HttpResponse; 
org.apache.http.HttpStatus; 
org.apache.http.client.HttpClient; 
org.apache.http.client.methods.HttpGet; 


android.app.Activity; 
android.os.Bundle; 


android.view.View; 
android.widget.Button; 
android.widget.Toast; 


public class HttpActivity extends Activity ( 

GOverride 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
setContentView(R.layout.main); 
Button btn = (Button) findViewById(R.id.btn); 


btn. 


he 


private 


try 


setOnClickListener (new View.OnClickListener() { 
GOverride 
public void onClick(View v) ( 

execute(); 


void execute() ( 

{ 

MyApplication app = (MyApplication) this.getApplication(); 

// 获 取 MyApplication 实例 

HttpClient client = app.getHttpClient (); // 获 取 Httpclient 实例 

HttpGet get = new HttpGet ("http://192.168.1.57:8080/ 
web/TestServlet?id-1001&name-john&age-60"); 

HttpResponse response - client.execute (get); 

if (response.getStatusLine().getStatusCode() == 

HttpStatus.SC OK) ( 

InputStream is = response.getEntity().getContent(); 

String result = inStream2String(is); 
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Toast.makeText (this, result, Toast.LENGTH LONG).show(); 
) 
) catch (Exception e) ( 
e.printStackTrace(); 
} 
} 


// 将 输入 流转 换 成 字符 串 
private String inStream2String(InputStream is) throws Exception ( 
ByteArrayOutputStream baos = new ByteArrayOutputStream(); 
byte[] buf = new byte[1024]; 
int len = -1; 
while ((len = is.read(buf)) != -1) ( 
baos.write(buf, 0, len); 
) 
return new String (baos.toByteArray()); 


) 


此 时 执行 后 在 手机 屏幕 中 单 击 execute 按钮 后 会 显示 GET SUCCESS 的 提示 ， 如 图 3-10 
所 示 。 


BME 19:02 


GET_SUCCESS 


图 3-10 执行 效果 
3.4 使 用 标准 Java HO 


本 节 将 带领 读者 漫游 java.net 包 ， 按 照 网 络 方面 的 知识 来 逐步 学 习 Android 中 的 Java 
网 络 编程 。 在 讲解 过 程 中 穿插 了 一 些 有 用 的 演示 代码 ， 帮 助 大 家 加 深 对 各 个 知识 点 的 
理解 。 


Ha 
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3.4.1 IP 地 址 


PRIA IP 地 址 就 是 给 每 个 连接 在 Internet 上 的 主机 分 配 的 一 个 32 rbh. java.net 4 
HE IP 地址 的 类 是 InetAddress， 其 结构 如 图 3-11 所 示 。 


Hu 


处 


InetAddress 


*getAllByName() 
SgetByAddress() 
*getByName() 
*getHostName() 
*getLocalHost() 
*getAddress() 


InetdAddress Inet6Address 


图 3-11 InetAddress 结 构 
下 面 的 代码 演示 了 InetAddress 的 具体 用 法 : 


String GetHostAddress (String strHostName) 
t 

InetAddress address - null; 

try 

{ 

address = InetAddress.getByName (strHostName); 
} 

catch (UnknownHostException e) 

t 

System.out.println(e.getMessage()); 

} 

return InetAddress.getHostAddress () ; 

} 


void GetAllIP (String strHostName) 
t 

InetAddress[] add = null; 

try 

t 

add - InetAddress.getAllByName (strHostName); 
for(int i=0;i<addr.lenth;i++) 
System.out.println(addr[i]); 

} 

catch (UnknownHostException e) 

t 
System.out.println(e.getMessage()); 
} 

} 


上 述 代 码 非 常 简单 ， 但 是 有 一 点 需要 说 明 : 在 网 络 编程 时 ， 必 须 注意 异常 的 捕获 。 网 
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络 异 常 是 比较 正常 的 现象 ， 比 如 说 当前 网 络 繁忙 ， 网 络 连 接 超时 更 是 “家 常 便 饭 ”。 因 
此 在 网 络 编程 时 ， 必 须 养 成 捕获 异常 的 好 习惯 ， 查 看 完 函 数 说 明 后 ， 要 注意 网 络 异 常 的 
说 明 。 特 别 注意 ， 在 使 用 getByAddress0 函 数 的 时 候 就 必须 捕获 UnknownHostException 


3.4.2 BH#+Socket# 
套 接 字 Socket 类 的 基本 结构 如 图 3-12 所 示 。 


Socket 


*bind() 

*close() 
*connect() 
*getinputStream() 
*getlnetAddress() 
*getOutputStream() 


图 3-12 ”Socket 结 构 


套 接 字 通信 的 基本 思想 比较 简单 ， 客 户 端 建立 一 个 到 服务 器 的 连接 ， 一 旦 连接 建立 
了 ， 客 户 端 就 可 以 往 套 接 字 中 写 入 数据 ， 并 向 服务 器 发 送 数据 ， 反 过 来 ， 服 务 器 读 取 客 户 
端 写 入 套 接 字 中 的 数据 。 就 这 么 简单 ， 也 许 细节 会 复杂 些 ， 但 是 基本 思想 就 如 此 。 看 下 面 

- 段 使 用 Socket 类 的 代码 : 

void WebPing (String strURL) 

t 

try 

t 

InetAddress addr; 

Socket sock - new Socket (strURL, 80); 

Addr = sock.getInetAddress (); 

System.out.println("Connceted to"+addr) ; 

Sock.close(); 

} 

catch (IOException e) 

{ 

System.out.println(e.getMessage()); 

} 

} 


如 果 使 用 本 地 主机 (localhost) 来 测试 这 个 程序 ， 则 输出 如 下 结果 : 

Connceted to localhost/127.0.0.1 

其 中 InetAddress.toString0 的 隐 含 调用 (println 调用 ) 自 动 输出 主机 名 和 IP 地 址 。 另 外 还 
有 其 他 套 接 字 ， 例 如 DatagramSocket( 通 过 UDP 通信 的 套 接 字 )、MulticastSocket( 一 种 用 于 
多 点 传送 的 套 接 字 ) 以 及 ServerSocket( 一 种 用 于 监听 来 自 客户 端的 连接 的 套 接 字 )， 在 这 里 
就 不 再 一 一 说 明 。 
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3.5 使 用 Android 网 络 接口 


在 Android 平台 中 ， 可 以 使 用 Android 网 络 接口 android.net.http 来 处 理 HTTP 请 求 。 


android.net.http 是 android.net 中 的 一 个 包 ， 主 要 包含 处 理 SSL 证 书 的 类 。 


3.5.4 android.net.http Ay 


H, 


在 android.net.http 中 存在 以 下 4 个 类 。 

Q AndroidHttpClient 

Q SslCertificate 

Q SslCertificate.DName 

Q SslError 

其 中 AndroidHttpClient 就 是 用 来 处 理 HTTP 请 求 的 。 

android.net.* 实 际 上 是 通过 对 Apache 的 HttpClient 的 封装 来 实现 的 一 个 HTTP 编程 接 
同时 还 提供 了 HTTP 请 求 队列 管理 ， 以 及 HTTP 连接 池 管 理 ， 以 提高 并 发 请 求情 况 下 


(如 转载 网 页 时 ) 的 处 理 效 率 ， 除 此 之 外 还 有 了 网络 状态 监视 等 接口 。 


整 性 


下 面 是 一 个 通过 AndroidHttpClient 访问 服务 器 的 简单 例子 : 


import import android.net.http.AndroidHttpClient; 
try ( 

AndroidHttpClient client = AndroidHttpClient.newInstance 
("your user agent"); 

// 创建 HttpGet 方法 ， 该 方法 会 自动 处 理 URL. 地 址 的 重 定向 

HttpGet httpGet = new HttpGet ("http://www.test test.com/"); 

HttpResponse response = client.execute (httpGet); 

if (response.getStatusLine().getStatusCode() != HttpStatus.SC OK) ( 
// 错误 处 理 


// 关闭 连接 
client.close(); 
} catch (Exception ee) { 
} 


另外 当 我 们 的 应 用 需要 同时 从 不 同 的 主机 获取 数目 不 等 的 数据 ， 并 且 仅 关心 数据 的 完 
而 不 关心 其 先后 顺序 时 ， 也 可 以 使 用 这 部 分 的 接口 。 典 型 用 例 就 是 android.webkit 在 
网 页 和 下 载 网 页 资源 时 ， 具 体 可 参考 android.webkit.* 中 的 相关 类 来 实现 。 


3.5.2 ”在 手机 屏幕 中 传递 HTTP 参 数 


通过 前 面 的 学 习 ， 了 解 到 HTTP 是 一 种 网 络 传输 协议 ， 现 实 中 的 大 多 数 网 页 都 是 通过 


“HTTP:W/WWW.” 的 形式 实现 显示 的 。 在 具体 应 用 时 ， 一 些 需 要 的 数据 都 是 通过 其 参数 传 


递 的 


。 本 节 将 通过 一 个 具体 实例 来 讲解 在 手机 屏幕 中 传递 HTTP 参数 的 流程 。 
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x fil 功 能 源码 路 径 
实例 3-4 在 手机 屏幕 中 传递 HTTP 参数 下 载 路 径 :\daima\3\httpSHI 
1. 实现 思 


和 网 络 HTTP 有 关 的 是 HTTP protocol, 在 Android SDK 中 ， 集 成 了 Apache 的 
HttpClient 模块 。 通 过 这 些 模 块 ， 可 以 方便 地 编写 和 HTTP 有 关 的 程序 。 在 Android SDK 
中 通常 使 用 HttpClient 4.0。 

在 本 实例 中 插入 了 两 个 按钮 ， 一 个 用 于 以 Post 方式 获取 网 站 数据 ， 另 外 一 个 用 于 以 
Get 方式 获取 数据 ， 并 以 TextView 对 象 来 显示 由 服务 器 端的 返回 网 页 内 容 来 显示 连接 结 
果 。 当 然 首先 得 建立 和 HTTP 的 连接 ， 连 接 之 后 才能 获取 Web Server 返回 的 结果 。 


2. 具体 实现 
(1) 编写 布局 文件 main.xml， 主 要 代码 如 下 : 


<?xml version-"1.0" encoding="utf-8"?> 
<LinearLayout 
xmlns:android-"http://schemas.android.com/apk/res/android" 
android:background="@drawable/white" 
android:orientation="vertical" 
android:layout width="fill parent" 
android:layout height="fill parent" 
> 
<TextView 
android: id="@+id/myTextViewl" 
android:layout width="fill parent" 
android:layout height="wrap content" 
android:text="@string/title"/> 
<Button 
android: id="@+id/myButton1" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:text="@string/str buttonl" /> 
<Button 
android: id="@+id/myButton2" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:text="@string/str_button2" /> 
</LinearLayout> 


(2) 编写 文件 httpSHIjava， 其 具体 实现 流程 如 下 。 

© 引用 apache.http 相关 类 实现 HTTP 联机 ， 然 后 引用 java.io 与 java.util 相关 类 来 读 
写 档案 。 具 体 代码 如 下 : 

/* 引 用 apache.http 相关 类 来 建立 HTTP 联机 */ 

import org.apache.http.HttpResponse; 

import org.apache.http.NameValuePair; 


import org.apache.http.client.ClientProtocolException; 
import org.apache.http.client.entity.UrlEncodedFormEntity; 


import 
import 
import 
import 
import 
import 
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org.apache.http.client.methods.HttpGet; 
org.apache.http.client.methods.HttpPost; 
org.apache.http.impl.client.DefaultHttpClient; 
org.apache.http.message.BasicNameValuePair; 
org.apache.http.protocol.HTTP; 
org.apache.http.util.EntityUtils; 


/+* 必 须 引用 java.io 5 java.util 相关 类 来 读 写 档案 */ 


import 
import 
import 
import 
import 
import 


import 
import 
import 
import 
import 


irdc.httpSHI.R; 
java.io.IOException; 
java.util.ArrayList; 
java.util.List; 
java.util.regex.Matcher; 
java.util.regex.Pattern; 


android.app.Activity; 
android.os.Bundle; 
android.view.View; 
android.widget.Button; 
android.widget.TextView; 


Q) 使 用 OnClickListener 来 侦 听 单 击 第 一 个 按钮 事件 ， 声 明 网 址 字符 串 并 使 用 建立 
了 Post 方式 联机 ， 最 后 通过 mTextViewl.setText 输出 提示 字符 。 具 体 代 码 如 下 : 


/* 设 定 OnClickListener 来 侦 听 onclick 事件 */ 
mButton1.setOnClickListener (new Button.OnClickListener () 


{ 


/*Ài'5 onClick 事件 */ 
@override 
public void onClick(View v) 


{ 


ERAR 

String uriAPI = "http://www.dubblogs.cc:8751/Android/Test/API/ 
Post/index.php"; 

/* 建 立 HTTP Post 联机 */ 

HttpPost httpRequest = new HttpPost (uriAPI); 


/[* 
* Post 运行 传送 变量 必须 用 NameValuePair [] 数 组 存储 
E 


List <NameValuePair> params = new ArrayList <NameValuePair>(); 
params.add(new BasicNameValuePair("str", "I am Post String")); 
try 
{ 
httpRequest .setEntity (new UrlEncodedFormEntity (params, HTTP.UTF 8)); 
/* 取 得 HTTP 输出 */ 
HttpResponse httpResponse = new DefaultHttpClient () .execute (httpRequest) ; 
/* 如 果 状 态 码 为 200 */ 
if(httpResponse.getStatusLine().getStatusCode() == 200) 
t 
/* 获 取 应 答 字符 串 */ 
String strResult = EntityUtils.toString (httpResponse.getEntity()); 
mTextViewl.setText (strResult); 
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} 
else 
{ 
mTextViewl.setText ("Error Response: 
"+httpResponse.getStatusLine() .toString()); 
} 
} 
catch (ClientProtocolException e) 
{ 
mTextViewl.setText (e.getMessage() .toString()); 
e.printStackTrace(); 
} 
catch (IOException e) 
{ 
mTextViewl.setText (e.getMessage() .toString()); 
e.printstackTrace(); 
} 
catch (Exception e) 
{ 
mTextViewl.setText (e.getMessage() .toString()); 
e.printStackTrace () ; 
} 


} 
); 


@ 使 用 OnClickListener 来 侦 听 单 击 第 二 个 按钮 的 事件 ， 声 明 网 址 字符 串 并 建立 Get 
方式 的 联机 功能 ， 分 别 实现 发 出 HTTP 获取 请 求 、 获 取 应 答 字 符 串 和 删除 宛 余 字符 操作 ， 
最 后 通过 mTextViewl.setText 输出 提示 字符 。 具 体 代码 如 下 : 


mButton2.setOnClickListener (new Button.OnClickListener () 
{ 
@override 
public void onClick(View v) 
{ 
// TODO Auto-generated method stub 
/* 声 明 网 址 字符 串 */ 
String uriAPI = "http://www.XXXX.cc:8751/index.php?str=I+am+Get+String"; 
/* 建 立 HTTP Get 联机 */ 
HttpGet httpRequest = new HttpGet (uriAPI); 
try 
t 
/* KA HTTP 获取 请 求 */ 
HttpResponse httpResponse = new DefaultHttpClient () .execute (httpRequest) ; 
/* 若 状态 码 为 200 ok*/ 


if(httpResponse.getStatusLine().getStatusCode() == 200) 

t 
/* 获 取 应 答 字符 串 */ 
String strResult = EntityUtils.toString(httpResponse.getEntity ()); 
/* 删 除 元 余 字 符 */ 


strResult = eregi replace ("(MrWAn| Nr | Nn | Mn Nr) ", "", strResult); 
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mTextViewl.setText (strResult); 
H 
else 
t 
mTextViewl.setText("Error Response: 
"+httpResponse.getStatusLine() .toString()); 
} 
} 
catch (ClientProtocolException e) 
{ 
mTextViewl .setText (e.getMessage () .toString()); 
e.printStackTrace(); 
} 
catch (IOException e) 
{ 
mTextViewl.setText (e.getMessage() .toString()); 
e.printStackTrace(); 
} 
catch (Exception e) 
t 
mTextViewl.setText (e.getMessage().toString()); 
e.printStackTrace(); 
} 


}); 
} 
@ 定义 替换 字符 串 函 数 eregi_replace 来 替换 掉 一 些 非 法 字符 ， 具 体 代码 如 下 : 
/* 字符 串 替换 函数 */ 
public String eregi replace(String strFrom, String strTo, String strTarget) 
t 
String strPattern = "(?i)"«strFrom; 
Pattern p = Pattern.compile(strPattern) ; 
Matcher m = p.matcher(strTarget); 
if (m.find()) 
t 
return strTarget.replaceAll(strFrom, strTo); 
} 
erse 
t 
return strTarget; 
} 


} 
(3) 在 文件 AndroidManifest.xml 中 声明 网 络 连接 权限 ， 具 体 代码 如 下 : 


«uses-permission android:name-"android.permission.INTERNET"»«/uses-permission» 


执行 后 的 效果 如 图 3-13 所 示 ， 单 击 图 中 的 按钮 能 够 以 不 同方 式 获取 HTTP. 参数 。 
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使 用 POST 方式 


使 用 GET 方 式 


图 3-13 单 击 “ 使 用 PSST 方 式 ” 按 钮 后 的 效果 
SA 注意 ; ”在 Android 系统 中 打开 连接 的 通用 代码 如 下 : 


Intent it = new Intent(Intent.ACTION VIEW, 
Uri.parse("http://www.baidu.com")); 

it.setClassName ("com.Android.browser", 
"com.android.browser.BrowserActivity"); 

getContext () .startActivity (it); 


在 Android 系统 中 打开 本 地 网 页 的 通用 代码 如 下 : 


Intent intent-new Intent(); 

intent.setAction ("android.intent.action.VIEW") ; 

Uri CONTENT URI BROWSERS = Uri.parse 
("content : //com.android.htmlfileprovider/sdcard/123.htm1") ; 

intent .setData (CONTENT URI BROWSERS); 

intent.setClassName ("com.android.browser", 
"com.android.browser.BrowserActivity"); 

startActivity (intent); 


DEAS 


> 在 网 络 中 访问 一 个 网 页 时 ， 需 要 通过 URL 地 址 来 指定 将 
要 访问 的 页 面 。 在 互联 网 中 ，URL 是 我 们 访问 Web 页 面 的 地 


zm i 
ei» dt. AT URL 的 重要 性 ， 所 以 本 书 将 用 一 章 的 内 容 来 讲解 在 


Android 系统 中 处 理 URL 的 基本 知识 。 
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4.1 使 用 URL 类 


URL 是 Uniform Resource Locator 的 缩写 ， 意 为 统一 资源 定位 器 ， 它 是 指向 互联 网 
“资源 ”的 指针 。 资 源 可 以 是 简单 的 文件 或 目录 ， 也 可 以 是 对 更 为 复杂 的 对 象 引 用 ， 例 如 
对 数据 库 或 搜索 引擎 的 查询 。 通 常 URL 可 以 由 协议 名 、 主 机 、 端 口 和 资源 组 成 。 即 满足 
如 下 格式 : 


protocol://host:port/resourceName 


例如 下 面 的 URL 地址: 
http://www.oneedu.cn/Index.htm 


在 Android 系统 中 可 以 通过 URL 获取 网 络 资源 ， 其 中 URLConnection 和 
HttpURLConnection 是 最 为 常用 的 两 种 方式 。 


4.1.1 URL 类 基础 
在 Java 应 用 中 ， 为 我 们 提供 了 类 URL 来 处 理 和 URL 相 


关 的 知识 ， 此 类 的 具体 结构 如 图 4-1 所 示 。 JE 
类 URL 被 包含 在 Java.net 包 中 ， 此 类 是 Java 实现 网 络 编 | 
程 应 用 的 重要 内 容 。 类 URL 为 Java 访问 网 络 资源 提供 了 接 Sorties 
口 ， 通 过 这 些 接口 可 以 很 容易 地 访问 服务 器 上 的 文件 。 类 A T 
URL 有 以 下 四 种 常用 的 构造 方法 格式 。 eH 
(1) public URL(String spec): 其 功能 是 通过 一 个 表示 
URL 地 址 的 字符 串 构造 一 个 URL 对 象 ， 例 如 : 图 4-1 URL 结构 


URL a-new URL("http://www.baidu.com") 

(2) public URL(URL context, String spec): 其 功能 是 通过 基本 URL 和 相对 URL 指定 文 
件 构造 一 个 URL 对 象 ， 例 如 : 

URL b-new URL("index.jsp") 

(3) public URL(String protocolString host,String file): 其 功能 是 通过 协议 名 、 主 机 名 和 
相对 的 URL 指定 文件 构造 一 个 URL 对 象 ， 例 如 : 


URL c- new URL("http", "www.sina.com.cn", "download/index.html") 


(4) public URL(String protocol,String host,int port,String file): 其 功能 是 通过 协议 名 、 主 
机 名 和 端口 号 和 相对 的 URL 指定 文件 构造 一 个 URL 对 象 ， 例 如 : 


URL d= new URL("http", "www.sina.com.cn", "6870","download/index.html") 


t 


x i 功 能 源码 路 径 
实例 4-1 演示 异常 处 理 URL 的 方法 FA aima 4 WangURL java 


OB 4$ URL 处 理 
在 构造 URL 程序 时 ， 经 常会 发 生 MalformedURLException 异常 ， 此 时 需要 在 程序 中 
设置 异常 处 理 。 通 过 本 实例 的 演示 代码 ， 讲 解 URL 处 理 异 常 的 基本 知识 。 
import java.io.*; 
import java.net.*; 


public class WangURL 
t 


public static void main(String args[]) 
{ 
try 
{ 
URL ul=new URL("http://www.baidu.com/"); 
} 
catch (MalformedURLException e) 
{ 
System.out.println(e); 
) 
catch(IOException ee) 
t 
System.out.println(ee); 
} 
catch (Exception eee) 
{ 
System. out .println (eee); 
} 


} 

执行 上 述 程序 ， 在 网 络 没 有 错误 的 情况 下 不 会 有 任何 执行 效果 。 在 URL 类 中 有 很 多 
属性 ， 例 如 协议 名 、 主 机 名 和 端口 号 等 ， 当 对 象 产 生 后 ， 其 属性 是 不 能 改变 的 。 在 URL 
类 的 API 中 定义 了 很 多 方法 来 获得 这 些 属性 ， 下 面 列 出 了 一 些 经 常用 到 的 方法 。 

口 public String getProtocol0: 获取 该 URL 的 协议 名 。 

public String getHost(): 获取 该 URL 的 主机 名 。 

Q public int getPort(): 获取 该 URL 的 端口 号 。 

口 public String getFiel0: 获取 该 URL 的 文件 名 。 

口 public String getRef(): 获取 该 URL 在 文件 中 的 相对 位 置 。 

口 public String getQuery0: 获取 该 URL 的 路 径 。 

Q public String getPath(): 获取 该 URL 的 路 径 。 

Q public String getAuthority(): 获取 该 URL 的 权限 信息 。 


口 public String getUserInfo(): 获得 该 URL 的 锚 。 
使 用 上 述 方法 的 具体 过 程 非常 简单 ， 下 面 将 通过 一 个 具体 实例 来 讲解 使 用 API 方法 的 
实 _ 例 功 能 源码 路 径 


实例 4-2 获得 端口 号 和 URL 的 文件 名 TF UE 42 Maima M URLI java 
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URL] java 的 实现 代码 如 下 : 


import java.io.*; 
import java.net.*; 
public class URL1 
t 
public static void main(String args[]) 
{ 
try 
{ 
URL ul=new URL("http://mil.news.sohu.com/") ; 
// 获 取 该 URL 的 协议 名 
System.out.println (ul .getProtocol ()); 
// 获 取 该 URL 的 主机 名 
System. out .println(ul.getHost()); 
// 获 取 该 URL 的 端口 号 
System.out.println(ul.getPort()); 
// 获 取 该 URL 的 文件 名 
System.out.println(ul.getFile()); 
) 
catch (MalformedURLException e) 
t 
System.out.println(e); 
} 
catch (IOException ee) 
{ 
System.out.println (ee); 
} 
catch (Exception eee) 
{ 
System.out.println (eee); 
} 


} 
执行 上 述 代 码 后 的 效果 如 图 4-2 所 示 。 


区 问题 | @ Javadoc [© Declaration E) 控制 台 52 =o 
EFE» URLI [Java 应 用 程序 ] C:\Progran Files\Java i ge 5€ Cw SS) re B- r3- 
http zm 

nil. news. sohu. com 

Ei 

/ 


图 4-2 执行 效果 
在 实例 4-2 中 ， 讲 解 了 获取 URL 的 一 些 常用 信息 ， 下 面 展示 一 段 代 码 ， 将 前 面 讲解 的 
VO 和 这 个 知识 点 结合 ， 读 者 将 代码 从 光盘 复制 到 自己 的 电脑 中 ， 进 行 编译 ， 查 看 结果 。 
其 代码 如 Fe 


import java.io.*; 
import java.net.*; 


OB 4$ URL 处 理 
public class URL2 
t 
public static void main(String args[]) 
t 
try 
t 
// 创 建 一 个 URL 对 象 
URL ul-new URL("http://www.163.com/"); 
// 构 造 一 个 BufferedReader 对 象 
BufferedReader br-new BufferedReader( 
new InputStreamReader (ul.openStream())); 
String s; 
// 从 输入 流 不 停 地 读数 据 ， 直 到 读 完 为 止 


while((s-br.readLine())'!-null) 


{ 
// 把 读 入 的 数据 打印 出 来 
System.out.println(s); 
} 
// 关 闭 输 入 流 


br.close(); 
) 
catch (MalformedURLException e) 
{ 
System.out.println(e); 
} 
catch (IOException ee) 
{ 
System.out.println (ee); 
} 
catch (Exception eee) 
{ 
System.out.println (eee); 
) 


4.1.2. URI 和 URL 的 使 用 


在 JDK 中 还 提供 了 一 个 名 为 URI 的 类 ，URI 是 Uniform Resource Identifiers 的 缩写 。 
URI 的 实例 代表 一 个 统一 资源 标识 符 ，Java 中 的 URI 不 能 用 于 定位 任何 资源 ， 其 唯一 作用 
就 是 解析 。 与 此 相对 应 的 是 ，URL 包含 了 一 个 可 打开 到 达 该 资源 的 输入 流 ， 因 此 可 以 将 
URL 理解 成 URI 的 特例 。 

在 类 URL 中 提供 了 多 个 构造 器 用 于 创建 URL 对 象 ， 一 旦 获得 了 URL 对 象 后 ， 就 可 
以 调用 下 面 的 方法 来 访问 该 URL 对 应 的 资源 。 

Q String getFile0: 获取 此 URL 的 资源 名 。 

OQ String getHost(): 获取 此 URL 的 主机 名 。 

Q String getPath): 获取 此 URL 的 路 径 部 分 。 
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int getPort(): 获取 此 URL 的 端口 号 。 
String getProtocol(): 获取 此 URL 的 协议 名 称 。 
String getQuery(): 获取 此 URL 的 查询 字符 串 部 分 。 
URLConnection openConnection(): 返回 一 个 URLConnection 对 象 ， 它 表示 到 
URL 所 引用 的 远程 对 象 的 连接 。 

O InputStream openStream(): 打开 与 此 URL 的 连接 ， 并 返回 一 个 用 于 读 取 该 URL 

资源 的 InputStream。 

了 解 了 上 述 URL 类 的 基本 知识 后 ， 接 下 来 将 通过 几 段 演示 代码 来 简要 介绍 使 用 类 
URL 的 基本 知识 。 

1. 使 用 URL 实 现 多 线程 下 载 

在 上 面 列 出 的 前 几 个 方法 都 非常 容易 理解 ， 可 以 使 用 其 中 的 方法 openStream0 读 取 该 
URL 资源 的 InputStream( 输 入 流 )， 通 过 该 方法 可 以 非常 方便 地 读 取 远 程 资 源 ， 甚 至 实现 多 
线程 下 载 。 例 如 下 面 的 演示 代码 : 


class DownThread extends Thread 


oooo 


{ 

// 定 义 字 节 数组 的 长 度 

private final int BUFF LEN = 32; 

// 定 义 下 载 的 起 始点 

private long start; 

// 定 义 下 载 的 结束 点 

private long end; 

// 下 载 资源 对 应 的 输入 流 

private InputStream is; 

// 将 下 载 到 的 字 节 输出 到 raf 中 

private RandomAccessFile raf ; 

// 构 造 器 ， 传 入 输入 流 、 输 出 流 和 下 载 起 始点 、 结 束 点 
public DownThread(long start , long end 
, InputStream is , RandomAccessFile raf) 


t 

// 输 出 该 线程 负责 下 载 的 字 节 位 置 
System.out.println(start + "---->" + end); 
this.start = start; 

this.end = end; 

this.is = is; 

this.raf = raf; 

} 

public void run() 

t 

try 

t 

is.skip(start); 

raf.seek(start); 

// 定 义 读 取 输 入 流 内 容 的 缓存 数组 

byte[] buff = new byte[BUFF LEN]; 
// 本 线程 负责 下 载 资源 的 大 小 


long contentLen = end - start; 
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// 定 义 最 多 需要 读 取 几 次 就 可 以 完成 本 线程 的 下 载 
long times = contentLen / BUFF LEN + 4; 
// 实 际 读 取 的 字 节 数 

int hasRead = 0; 

for (int i = 0; i « times ; i++) 

t 

hasRead = is.read(buff); 

// 如 果 读 取 的 字 节 数 小 于 0， 则 退出 循环 ! 

if (hasRead < 0) 

t 

break; 

$ 

raf.write(buff , 0 , hasRead); 
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catch (Exception ex) 

t 

ex.printstackTrace(); 


) 

// 使 用 finally 块 来 关闭 当前 线程 的 输入 流 、 输 出 流 
finally 

t 

try 

t 

if (is != null) 

t 

is.close(); 

} 

if (raf != null) 

{ 

raf.close(); 

} 

} 

catch (Exception ex) 

{ 

ex.printstackTrace(); 

) 

) 

b 

} 

public class MutilDown 

{ 

public static void main(string[] args) 

{ 

final int DOWN THREAD NUM = 4; 

final String OUT FILE NAME = "down.jpg"; 
InputStream[] isArr = new InputStream[DOWN THREAD NUM]; 


URL 处 理 


RandomAccessFile[] outArr = new RandomAccessFile[DOWN THREAD NUM]; 


try 


{ 
// 创 建 一 个 URL WH 
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URL url = new URL("http://images.china-pub.com/-*"ebook35001- 
40000/35850/shupi.jpg"); 

// 以 此 URL 对 象 打 开 第 一 个 输入 流 

isArr[0] = url.openStream(); 

long fileLen - getFileLength (url); 

System.out.println(" 网 络 资源 的 大 小 ”+ fileLen); 

// 以 输出 文件 名 创建 第 一 个 RandomAccessFile 输出 流 

outArr[0] = new RandomAccessFile(OUT FILE NAME , "rw"); 

// 创 建 一 个 与 下 载 资源 相同 大 小 的 空 文件 

for (unt 2 — 0 7 i < fitenen ; rtt) 

t 

outArr[0].write(0); 


) 

// 每 线程 应 该 下 载 的 字 节 数 

long numPerThred = fileLen / DOWN THREAD NUM; 
// 整 个 下 载 资 源 整除 后 剩 下 的 余数 

long left = fileLen $ DOWN THREAD NUM; 

for (int i = 0; i « DOWN THREAD NUM; i++) 


t 

// 为 每 个 线程 打开 一 个 输入 流 、 一 个 RandomAccessFile 对 象 ， 
// 让 每 个 线程 分 别 负责 下 载 资源 的 不 同 部 分 。 

if (i != 0) 


{ 

// 以 URL 打开 多 个 输入 流 

isArr = url.openStream(); 

// 以 指定 输出 文件 创建 多 个 RandomAccessFile WR 

outArr = new RandomAccessFile(OUT FILE NAME , "rw"); 


} 

// 分 别 启动 多 个 线程 来 下 载 网 络 资源 

if (i == DOWN THREAD NUM - 1 ) 

{ 

// 最 后 一 个 线程 下 载 指定 numPerThred+left 个 字 节 

new DownThread(i * numPerThred , (i + 1) * numPerThred + left, isArr , 
outArr).start(); 

) 

else 

{ 

// 每 个 线程 负责 下 载 一 定 的 numPerThred 个 字 节 

new DownThread(i * numPerThred , (i + 1) * numPerThred, 

isArr , outArr).start(); 

) 

} 

E 

catch (Exception ex) 

{ 

ex.printstackTrace(); 

$ 


} 
// 定 义 获取 指定 网 络 资源 的 长 度 的 方法 
public static long getFileLength(URL url) throws Exception 
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long length = 0; 

// 打 开 该 URL 对 应 的 URLConnection 

URLConnection con = url.openConnection(); 

// 获取 连接 URL 资源 的 长 度 

long size = con.getContentLength(); 

length = size; 

return length; 

} 
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在 上 面 的 代码 中 ， 定 义 了 一 个 名 为 DownThread 线程 类 ， 该 线程 从 start( 开 
始 )InputStream 中 读 取 数据 ， 到 end( 结 束 ) 时 完成 所 有 字 节 数据 的 读 取 工 作 ， 并 写 入 
RandomAccessFile 对 象 。 这 个 DownThread 线程 类 的 方法 rn0 就 是 一 个 简单 的 输入 、 输 出 
实现 。 

在 上 述 代 码 中 的 MutilDown 类 中 ， 方 法 main0 按 以 下 步骤 来 实现 多 线程 下 载 。 

(1) 创建 URL 对 象 。 

(2) 获取 指定 URL 对 象 所 指向 资源 的 大 小 (由 getFileLength 方法 实现 )， 此 处 用 到 了 
URLConnection 类 ， 该 类 代表 Java 应 用 程序 和 URL 之 间 的 通信 连接 。 

(3) 在 本 地 磁盘 上 创建 一 个 与 网 络 资源 相同 大 小 的 空 文件 。 

(4) 计算 每 条 线程 应 该 下 载 网 络 资源 的 哪个 部 分 (从 哪个 字 节 开始 ， 到 哪个 字 节 结束 )。 

(5) 依次 创建 、 启 动 多 条 线程 来 下 载 网 络 资源 的 指定 部 分 。 

上 面 程序 已 经 实现 了 多 线程 下 载 的 核心 代码 ， 如 果 要 实现 断 点 下 载 ， 则 还 需要 额外 增 
加 一 个 配置 文件 ， 该 配置 文件 分 别 记录 每 个 线程 已 经 下 载 到 了 哪个 字 节 ， 当 网 络 断 开 后 再 
次 开始 下 载 时 ， 每 个 线程 根据 配置 文件 里 记录 的 位 置 向 后 下 载 即 可 。 

在 URL 中 ， 可 以 通过 方法 openConnection0 返 回 一 个 URLConnection 对 象 ， 该 对 象 表 
示 应 用 程序 和 URL 之 间 的 通信 连接 。 程 序 可 以 通过 URLConnection 实例 向 该 URL 发 送 请 
求 、 读 取 URL 引用 的 资源 。 

创建 一 个 和 URL 的 连接 ， 并 发 送 请 求 、 读 取 此 URL 引用 资源 的 基本 步骤 如 下 。 

(1) 通过 调用 URL 对 象 openConnection() 方 法 来 创建 URLConnection 对 象 。 

(2) 设置 URLConnection 的 参数 和 普通 请 求 属性 。 

(3) 如 果 只 是 发 送 Get 方式 请 求 ， 使 用 Connect 方法 建立 和 远程 资源 之 间 的 实际 连接 
即 可 ;如果 需要 发 送 Post 方式 的 请 求 ， 需 要 获取 URLConnection 实例 对 应 的 输出 流 来 发 送 
请 求 参 数 。 

(4) 如 果 远 程 资 源 可 用 ， 此 时 程序 可 以 访问 远程 资源 的 头 字段 或 通过 输入 流 读 取 远 程 
资源 的 数据 。 

在 建立 和 远程 资源 的 实际 连接 之 前 ， 我 们 可 以 通过 以 下 方法 来 设置 请 求 头 字 段 。 

口 setAllowUserInteraction: 设置 该 URLConnection 的 allowUserlInteraction 请 求 头 字 

段 的 值 。 

OQ setDoInput: 设置 该 URLConnection 的 doInput 请 求 头 字段 的 值 。 

OQ  setDoOutput:. 设置 该 URLConnection 的 doOutput 请 求 头 字段 的 值 。 
口 
口 


setIfModifiedSince: 设置 该 URLConnection 的 ifModifiedSince 请 求 头 字 段 的 值 。 
setUseCaches: 设置 该 URLConnection 的 useCaches 请 求 头 字 段 的 值 。 
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除 此 之 外 ， 还 可 以 使 用 以 下 方法 来 设置 或 增加 通用 头 字 段 。 
Q  setRequestProperty(String key, String value): 设置 该 URLConnection 的 key 请 求 头 
字段 的 值 为 value。 例 如 下 面 的 代码 : 


conn.setRequestProperty("accept" , "*/*") 


OQ  addRequestProperty(String key, String value): 为 该 URLConnection 的 key 请 求 头 字 
段 增加 value 值 ， 该 方法 并 不 会 覆盖 原 请 求 头 字段 的 值 ， 而 是 将 新 值 追加 到 原 请 
求 头 字段 中 。 

当 远 程 资源 可 用 之 后 ， 程 序 可 以 使 用 以 下 方法 来 访问 头 字 段 和 内 容 。 

Q “Object getContent(): 获取 该 URLConnection 的 内 容 。 

Q String getHeaderField(String name): 获取 指定 响应 头 字 段 的 值 。 

OQ getlnputStream(): 返回 该 URLConnection 对 应 的 输入 流 ， 用 于 获取 URLConnection 


响应 的 内 容 。 
OQ getOutputStream(): 返回 该 URLConnection 对 应 的 输出 流 ， 用 于 向 URLConnection 
发 送 请 求 参 数 。 


EGER: 如 果 既 要 使 用 输入 流 读 取 URLConnection 响应 的 内 容 ， 又 要 使 用 输出 流 发 送 
请 求 参数 ， 一 定 要 先 使 用 输出 流 ， 再 使 用 输入 流 。 


方法 getHeaderField0 可 以 根据 响应 头 字 段 来 返回 对 应 的 值 。 而 某 些 头 字段 由 于 经 常 需 
要 访问 ， 所 以 Java 提供 以 下 方法 来 访问 特定 响应 头 字段 的 值 。 

Q  getContentEncoding: 获取 content-encoding 响应 头 字段 的 值 。 

getContentLength: 获取 content-length 响应 头 字段 的 值 。 

Q getContentType: 获取 content-type 响应 头 字段 的 值 。 

口 getDate(): 获取 date 响应 头 字 段 的 值 。 

口 getExpiration(): 获取 expiration 响应 头 字 段 的 值 。 

口 getLastModified(): 获取 last-modified 响应 头 字 段 的 值 。 

2. 使 用 URL 实 现 和 站 点 的 交互 

在 日 常 项 目 应 用 中 ， 经 常 需 要 向 Web 站 点 发 送 Get 请 求 、Post 请 求 ， 并 从 Web 站 点 
获得 响应 。 例 如 我 们 可 以 通过 如 下 代码 来 实现 : 

public class TestGetPost 

T 

Ji ** 

* 向 指定 URL 发 送 Get 方法 的 请 求 

* @param url 发 送 请 求 的 URL 

* @param param 请 求 参数 ， 请 求 参 数 应 该 是 namel=valuel&name2=value2 的 形式 

* @return URL 所 代表 远程 资源 的 响应 

gi 

public static String sendGet(String url , String param) 

{ 

String result = ""; 

BufferedReader in - null; 

try 
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{ 

String urlName = url + "?" + param; 

URL realUrl new URL(urlName); 

// 打 开 和 URL 之 间 的 连接 

URLConnection conn = realUrl.openConnection(); 
// 设 置 通用 的 请 求 属性 
conn.setRequestProperty("accept", "*/*"); 
conn.setRequestProperty ("connection", "Keep-Alive"); 
conn.setRequestProperty ("user-agent", 
"Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1)"); 
// 建 立 实际 的 连接 

conn.connect () ; 

// 获 取 所 有 响应 头 字段 

Map<String，List<String>> map = conn.getHeaderFields(); 
// 遍 历 所 有 的 响应 头 字段 

for (String key : map.keySet()) 

t 

System.out.println(key + "--->" + map.get (key) ); 
} 

/ /3& X BufferedReader 输入 流 来 读 取 URL 的 响应 

in = new BufferedReader( 

new InputStreamReader (conn.getInputStream())); 
String line; 

while ((line = in.readLine())!= null) 

t 

esult += "n" + line; 

) 

) 

catch (Exception e) 

t 

System.out .println ("RIŽ GET 请 求 出 现 异 常 ! " + e); 
e.printStackTrace(); 

) 

// 使 用 £inally 块 来 关闭 输入 流 

finally 

t 

try 

t 

if (in != null) 

t 

in.close(); 

l 

} 

catch (IOException ex) 

t 

ex.printstackTrace(); 
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} 

return result; 
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向 指定 URL 发 送 Post 方法 的 请 求 

@param url 发 送 请 求 的 URL 

@param param 请 求 参数 ， 请 求 参数 应 该 是 namel=valuel&gname2=value2 的 形式 
@return URL 所 代表 远程 资源 的 响应 

Ü 

public static String sendPost(String url,String param) 
t 

PrintWriter out - null; 

BufferedReader in - null; 

String result - ""; 

try 

t 

URL realUrl = new URL (url); 

// 打 开 和 URL 之 间 的 连接 

URLConnection conn = realUrl.openConnection(); 
// 设 置 通 用 的 请 求 属性 
conn.setRequestProperty("accept", "*/*"); 
conn.setRequestProperty ("connection", "Keep-Alive"); 
conn.setRequestProperty ("user-agent", 
"Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1)"); 
// 发 送 Post 请 求 必须 设置 如 下 两 行 

conn.setDoOutput (true); 

conn.setDoInput (true); 

// 获取 URLConnect ion 对 象 对 应 的 输出 流 

out = new PrintWriter (conn.getOutputStream()); 
// 发 送 请 求 参 数 

out.print (param); 

//flush 输出 流 的 缓冲 

out.flush(); 

//3& X BufferedReader 输入 流 来 读 取 URL 的 响应 

in = new BufferedReader( 

new InputStreamReader (conn.getInputStream())); 
String line; 

while ((line = in.readLine())!= null) 

t 

result += "n" + line; 

) 

) 

catch(Exception e) 

t 

System.out .println ("发 送 POST 请 求 出 现 异常 ! " + e); 
e.printStackTrace(); 
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$ 

// 使 用 finally 块 来 关闭 输出 流 、 输 入 流 
finally 

t 

try 

t 

if (out !— null) 

t 

out.close(); 
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} 

if (in != null) 

{ 

in.close(); 

} 

} 

catch (IOException ex) 
{ 
ex.printStackTrace(); 
} 

} 

return result; 


} 
// 提 供 主 方法 ， 测 试 发 送 Get 请 求 和 Post 请 求 


public static void main(String args[]) 


t 

// 发 送 Get 请 求 

String s = TestGetPost.sendGet ("http://localhost:8888/abc/ 
login.jsp",null); 

System.out.println(s); 

// 发 送 Post 请 求 

String sl = TestGetPost.sendPost ("http://localhost:8888/abc/a.jsp", 
"user- "EHl&pass-abc"); 

System.out.println(s1); 

i 

i 


在 上 述 代 码 中 ， 在 发 送 Get 请 求 时 只 需 将 请 求 参数 放 在 URL 字符 串 之 后 用 “?” 隔 
开 ， 程 序 直接 调用 URLConnection 对 象 的 Connect 方法 即 可 。 如 果 程 序 需 要 发 送 Post 请 
求 ， 则 需要 先 设置 doln 和 doOut 两 个 请 求 头 字段 的 值 ， 然 后 再 使 用 URLConnection 对 应 
的 输出 流 来 发 送 请 求 参 数 即 可 。 
不 管 是 发 送 Get ii 还 是 发 送 Post 请 求 ， 程 序 获取 URLConnection 响应 的 方式 完全 
- 样 : 如 果 程 序 可 以 确定 远程 响应 是 字符 流 ， 则 可 以 使 用 字符 流 来 读 取 ; 如 果 程 序 无 法 确 
定 远程 响应 是 字符 流 ， 则 使 用 字 节 流 读 取 即 可 。 


4.2 使 用 URLConnection 类 


在 一 般 情况 下 ，URL 类 就 可 以 满足 我 们 的 项 目 需 求 ， 但 是 在 一 些 特殊 情况 下 ， 比 如 
HTTP 数据 头 的 传递 ， 这 个 时 候 我 们 就 得 使 用 URLConncetion 类 。 类 URLConncetion 的 结 
构 如 图 4-3 所 示 。 

使 用 URLConncetion 类 后 ， 我 们 对 网 络 的 控制 就 增加 了 很 多 ， 例 如 下 面 的 代码 。 


void SendRequest (String strURL) 

t 

URL url = URL(strURL) ; 

HttpURLConnection conn = (HttpURLConnection)url.openConnection (); 
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conn.setDoInput (true); 
conn.setDoOutput (true); 
conn.setRequestProperty ("Content-type","application/xxx"); 
conn.connect (); 
System.out.println(Conn.getResponseMessage ()); 
InputMessage is = Conn.getIputStream(); 


int cr 
do{ 


c = is.read(); 


if(c!--1) System.out.printin((char)c); 


}while(c!=-1) 


) 


用 传统 的 Java 知识 。 在 接 下 来 的 内 容 


URLConnection 


*addRequestProperty() 
onnect() 
*getContentEncoding() 
*getContentLength() 
*getContentType() 
*getDate() 
*getExpiration() 
*getDolnput() 
*getDoOutput() 
*getinputStream() 
*getOutputStream() 
‘SgetLastModified) 
*getRequestProperty() 
*setRequestProperty() 
*getHeaderFields() 


HttpURL Connection 
@HTTP_OK : int = 200 
9HTTP ACCEPTED : int = 202 
9HTTP FORBIDDEN : int = 403 
@HTTP_NOT_FOUND : int = 404 


*isconnect() 
‘SgetResponseC ode) 
*getErrorStream() 
*getRequestMethod() 

S getRespons eMessage() 
SsetRequestMethod() 


JarURL Connection 


S 


HttpsURL Connection 
pu] 


图 4-3 ”URLConncetion 结 构 
其 实在 编程 时 ， 我 们 无 须 担心 普通 Java 平台 和 Android 平台 的 差异 ， 我 们 完全 可 以 使 


URLConnection 的 基本 流程 。 
1. 在 手机 屏幕 中 显示 QQ 空间 中 的 照片 


网 络 真是 无 奇 不 有 ， 在 QQ 空间 中 


ph， 将 通过 具体 实例 来 讲解 在 Android 中 使 用 


Ph 可 以 存放 我 们 的 照片 。 


实 例 功 能 源码 路 径 
实例 4-3 在 手机 屏幕 中 显示 QQ 空间 中 的 照片 TF 333542 aima AQQ 
在 本 实例 中 ， 直 接 在 Gallery 中 显示 QQ 空间 中 的 照片 ， 这 样 可 以 节约 手机 的 存储 空 


间 。 在 具体 实现 上 ， 需 要 将 URL 网 址 的 照片 实时 处 理 下 载 后 ， 以 InputStream 转换 为 
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Bitmap， 这 样 才能 放 入 BaseAdapter 中 取 用 。 在 运行 实例 前 ， 需 要 预先 准备 照片 并 上 传 到 
网 络 空间 中 ， 在 获取 照片 的 连接 后 ， 再 以 String 数组 方式 放 在 程序 中 ， 并 对 BaseAdapter 
稍 作 修改 ， 加 上 URL 对 象 的 访问 以 及 URLConnection 连接 的 处 理 。 

(1) 编写 布局 文件 main.xml， 在 里 面 插入 了 一 个 Gallery 控件 来 实现 滑动 照片 效果 。 具 
体 代码 如 下 : 


<?xml version-"1.0" encoding="utf-8"?> 

<LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android: id="@+id/myLinearLayout" 
android:orientation-"vertical" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
> 
<Gallery 
android: id="@+id/myGallery01" 
android:layout width-"fill parent" 
android:layout height-"fill parent"> 
«/Gallery» 

</LinearLayout> 


(2) 编写 主 程序 文件 QQjava， 其 具体 实现 流程 如 下 。 
® 分 别 声明 在 Gallery 中 要 显示 的 5 张 图 片 的 地 址 栏 字符 串 ， 有 具体 代码 如 下 : 
public class QQ extends Activity 
t 
private Gallery myGallery01; 
/* 地 址 栏 字符 串 */ 
private String[] myImageURL = new String[] 
{ 


"http://b27.photo.store.qq.com/http imgload.cgi?/" 
+ "rurl4 b-086a67cbd6a8cfb4389ea2b48efab6f322f755a085107a7aeeaa56 
£c1358b1bd124186254e021£0655732688e69f060725491f8ae82e8e5508dbe 
9821670e2baf04e92dedc97e3bbf28e5605596aa991c13220f1&a-27&b-27", 
"http://b27.photo.store.qq.com/http imgload.cgi?/" 
+ "rurl4 b-086a67cbd6a8cfb4389ea2b48efab6f3ea78f5797abbbaa617259 
f2d2a980a5468f£2801897cfcc2b78af92fbb87565ed7a3a08041daff2dd9ccd 
26d3cc6198e41£2d205c8a0c445325771e8a179215999afaf9f3&a-27&b-27", 
"http://b27.photo.store.qq.com/http imgload.cgi?/" 
+ "rurl4 b-2a9dcfl1fd909a7ed3ce8951f738608982f26d812b3a5fc96e221 
585fc085e7cc3264ee20730£0£d3al1f7aca06740db7a615349357467ca39£82 
b866b6fbe3cd94bbdd10ed01841e67c95d8e4af8890b7ced40869&a-30&b-27", 
"http://b27.photo.store.qq.com/http imgload.cgi?/" 
+ "rurl4 b-2a9dcflfd909a7ed3ce8951f73860898bb7ff57a8cb7747c9f0eb6 
a02124850b709c0b86f086a4ba5653eeb71dd4b01e4a58f407e2eec9433cd8 
d4bc0b88fda56260c2c8beb34ebab7 7b610C7131393£82e774ef &a=27 &b=27", 
"http://b27.photo.store.qq.com/http imgload.cgi?/" 
+ "rurl4 b-2a9dcfl1fd909a7ed3ce8951f738608981588252489f84e7d2a83 
d44c01b7bb12b2cl19ca0efdd555dba788407f£d01e9de45524b11a9793f53262 
4197bc8d14c84ae78ddebafe4357e4eedc60e9e510224367490bf&a-27&b-27" ); 


Q) 引入 布局 文件 main.xml， 定 义 类 成 员 myContext Context 对 象 ， 然 后 设置 具有 一 个 


. 
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参数 C 的 构造 器 。 具 体 代码 如 下 : 
public void onCreate (Bundle savedInstanceState) 
t 
super.onCreate (savedInstanceState); 
setContentView (R.layout.main); 
myGallery01 = (Gallery) findViewById (R.id.myGallery01); 
myGalleryOl.setAdapter (new myInternetGalleryAdapter (this) ); 
} 
/* Hi BaseAdapter */ 
public class myInternetGalleryAdapter extends BaseAdapter 
t 
/* 类 成 员 myContext Context WH */ 
private Context myContext; 
private int mGalleryItemBackground; 
/* 构 造 器 只 有 一 个 参数 ， 即 要 存储 的 Context */ 
public myInternetGalleryAdapter (Context c) 
t 
this.myContext = c; 
TypedArray a - myContext 
-obtainStyledAttributes (R.styleable.Gallery); 
/* 3M Gallery 属性 的 Index id */ 
mGalleryItemBackground - a.getResourceId( 
R.styleable.Gallery android galleryItemBackground, 0); 
/* 把 对 象 的 styleable 属性 能 够 反复 使 用 */ 
a.recycle(); 
} 


© 定义 方法 getCount() 来 返回 全 部 已 定义 照片 的 总 量 ， 定 义 方 法 getItem(int position) 
获取 当前 容器 中 照片 数 的 数组 ID 。 具 体 代码 如 下 : 
启运 回 全 部 已 定义 照片 的 总 量 */ 
public int getCount () 


t 
return myImageURL.length; 


} 
/* 使 用 getItem 方法 获取 当前 容器 中 照片 数 的 数组 ID */ 
public Object getItem(int position) 


t 
return position; 


) 
public long getItemId(int position) 


t 
return position; 


) 
® 定义 方法 getScale， 利 用 getScale 根据 中 央 位 移 量 返回 views 的 大 小 。 具 体 代码 
如 下 : 


/* 根据 中 央 位 移 量 ， 利 用 getscale 返回 views 的 大 小 (0.0f to 1.0f) */ 
public float getScale(boolean focused, int offset) 
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1E Pormula al, ff (2 ortsat)y eK 
return Math.max(0, 1.0f / (float) Math.pow(2, Math 
.abs (offset))); 
) 


执行 后 将 在 Gallery 中 显示 指定 的 照片 ， 如 图 4-4 所 示 。 


图 4-4 执行 效果 
2. 从 网 络 中 下 载 图 片 作为 屏幕 背景 
我 们 可 以 从 网 络 中 下 载 一 个 图 片 文件 来 作为 手机 屏幕 的 背景 。 


实例 4-4 从 网 络 中 下 载 图 片 作为 屏幕 背景 下 载 路 径 :\daima\4\pingmu 


本 实例 的 功能 是 远程 获取 网 络 中 的 - 张 图 片 ， 并 将 该 图 片 作为 手机 屏幕 的 背景 。: 
载 完 图 片 后 ， 通 过 InputStream 传 到 ContextWrapper 中 重 写 setWallpaper 的 方式 ee 
其 中 传 入 的 参数 是 URLConnection.getInputStream0 中 的 数据 内 容 。 本 实例 的 具体 实现 流程 
如 下 。 
(1) 编写 布局 文件 main.xml， 分 别 插入 一 个 文本 框 控件 和 按钮 控件 。 主 要 代码 如 下 : 
<EditText 
android: id="@+id/myEdit" 
android:layout width="280px" 
android:layout height="wrap content" 
android:text="http://" 
android:textSize="12sp" 
android:layout x="20px" 
android:layout y="42px" 
= 
</EditText> 
<TextView 
android:id="@+id/myText" 
android:layout_width="wrap_content" 
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android:layout height-"wrap content" 
android:text="@string/str title" 
android:textSize="16sp" 

android: textColor="@drawable/black" 
android: layout_x="20px" 
android:layout y="12px" 


> 
</TextView> 
<Button 
android: id="@+id/myButton1" 


android:layout width="80px" 
android:layout height="45px" 
android:text="@string/str buttonl" 
android:layout x="70px" 
android:layout y="102px" 

> 

</Button> 

<Button 
android:id="@+id/myButton2" 
android:layout width-"80px" 
android:layout height="45px" 
android:text="@string/str button2" 
android:layout x-"150px" 
android:layout y-"102px" 

m 

«/Button» 

«ImageView 
android: id="@+id/myImage" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:layout x="20px" 
android:layout y="152px" 

= 

</ImageView> 


(2) 编写 主 程序 文件 pingmu.java， 有 具体 实现 流程 如 下 。 
(D) 单 击 mButtonl 按钮 时 通过 mButtonl.setOnClickListener 来 预览 图 片 ， 如 果 网 址 为 
空 则 输出 空白 提示 ， 如 果 不 为 空 则 传 入 “type=1”， 表 示 预 览 图 片 。 具 体 代 码 如 下 : 


public void onCreate (Bundle savedInstanceState) 

t 
super.onCreate (savedInstanceState); 
setContentView (R.layout.main); 
/* 初始 化 对 象 */ 
mButtonl =(Button) findViewById(R.id.myButtonl); 
mButton2 -(Button) findViewById (R.id.myButton2); 
mEditText = (EditText) findViewById(R.id.myEdit); 
mImageView = (ImageView) findViewById (R.id.myImage); 
mButton2.setEnabled(false); 
/* 预览 图 片 的 Button */ 
mButtonl.setOnClickListener (new Button.OnClickListener() 


@override 
public void onClick(View v) 


{ 


he 


String path=mEditText.getText () .toString(); 
if (path.equals("") ) 
{ 
showDialog (" 网 址 不 可 为 空白 !") ; 
} 
else 
{ 
/* 传 入 type=1 为 预览 图 片 */ 
setImage (path, 1); 
} 
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© "il; mButton2 按钮 时 通过 mButton2.setOnClickListener 将 图 片 设置 为 桌面 。 如 果 
网 址 为 空 则 输出 空白 提示 ， 如 果 不 为 空 则 传 入 “type=2” 将 其 设置 为 


/* 将 图 片 设 为 桌面 的 Button */ 
mButton2.setOnClickListener(new Button.OnClickListener() 


{ 


@override 
public void onClick(View v) 


{ 


try 
{ 
String path=mEditText.getText () .toString(); 
if (path.equals("") ) 
{ 
showDialog ("网 址 不 可 为 空白 !"); 
} 
else 
{ 
/* 传 入 type=2 为 设置 桌面 */ 
setImage (path,2); 
} 
} 
catch (Exception e) 
t 
showDialog (" 读 取 错 误 ! 网 址 可 能 不 是 图 片 或 网 址 错误 !") ; 
bm = null; 
mImageView.setImageBitmap (bm); 
mButton2.setEnabled (false); 
e.printStackTrace(); 


桌面 。 具 体 代 码 如 下 : 
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© 定义 方法 setImage(String path,int type) 将 图 片 抓 取 预 览 并 设置 为 桌面 ， 如 果 有 异常 
则 输出 对 应 提示 。 具 体 代码 如 下 : 


/* 将 图 片 抓 下 来 预览 并 设置 为 桌面 的 方法 */ 
Private void setImage (String path, int type) 
t 
try 
t 
URL url - new URL (path); 
URLConnection conn = url.openConnection(); 
conn.connect () ; 
if (type==1) 
{ 
/* 预览 图 片 */ 
bm = BitmapFactory.decodeStream(conn.getInputStream()); 
mImageView.setImageBitmap (bm); 
mButton2.setEnabled (true); 
} 
else if(type--2) 
t 
/* 设置 为 桌面 */ 
Pingmu.this.setWallpaper (conn.getInputStream()); 
bm - null; 
mImageView.setImageBitmap (bm) ; 
mButton2.setEnabled (false) ; 
showDialog ("桌面 背景 设置 完成 1") ; 
} 
} 
catch (Exception e) 
{ 
showDialog (" 读 取 错 误 ! 网 址 可 能 不 是 图 片 或 网 址 错误 !") ; 
bm = null; 
mImageView.setImageBitmap (bm) ; 
mButton2.setEnabled (false); 
e.printStackTrace(); 


j 
® 定义 方法 showDialog(String mess) 来 弹出 一 个 对 话 框 ， 单 击 后 完成 背景 设置 。 具 体 
代码 如 下 : 
/* 弹出 Dialog 的 方法 */ 


private void showDialog(String mess) { 
new AlertDialog.Builder (example8.this) .setTitle ("Message") 
-SetMessage (mess) 
.setNegativeButton ("确定 ",，new DialogInterface.OnClickListener () 
{ 
public void onClick(DialogInterface dialog, int which) 
{ 
} 
}) 
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-Show() ; 
} 
} 
(3) 在 文件 droidManifestxml 中 需要 声明 SET WALLPAPER 权限 和 INTERNET 权 
限 ， 主 要 代码 如 下 : 


<uses-permission android:name="android.permission.SET WALLPAPER"/> 
«uses-permission android:name="android.permission.INTERNET"/> 


执行 后 在 屏幕 中 显示 一 个 输入 框 和 两 个 按钮 ， 如 图 4-5 所 示 ， 输 入 图 片 网 址 并 单 击 
“预览 ”按钮 后 ， 可 以 查看 此 图 片 。 单 击 “ 设 置 ” 按 钮 后 可 以 将 此 图 片 设置 为 屏幕 背景 。 


网 址 : 


http://i.firefoxchina.cn/images/upload/ 
mbs 20110824.jpg 


mu 设置 
EG on 2011 最 流行 初秋 dM 
5200330 
图 4-5 执行 效果 


4.3 使 用 HttpURLConnection 类 


在 javanet 类 中 ，HttpURLConnection 类 是 一 种 访问 HTTP 资源 的 方式 。 
HttpURLConnection 类 具有 完全 的 访问 能 力 ， 可 以 取代 HttpGet 和 HttpPost 类 。 本 节 将 详细 
讲解 HttpURLConnection 的 基本 用 法 。 


4.3.1 HttpURLConnection 的 主要 用 法 


在 实际 项 目 应 用 中 ， 使 用 类 HttpURLConnection 可 以 实现 以 下 4 个 功能 。 

1. 从 Internet 获 取 网 页 

在 实现 此 功能 时 ， 需 要 先 发 送 请 求 ， 然 后 将 网 页 以 流 的 形式 读 回来 。 

(1) 创建 一 个 URL 对 象 : 

URL url = new URL("http://www.sohu.com") ; 

(2) 利用 HttpURLConnection 对 象 从 网 络 中 获取 网 页 数据 : 
HttpURLConnection conn = (HttpURLConnection) url.openConnection(); 
G) 设置 连接 超时 : 


conn.setConnectTimeout (6* 1000); 
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(4) 对 响应 码 进行 判断 : 
if (conn.getResponseCode() != 200) throw new RuntimeException ("if url AM") ; 
(5) 得 到 网 络 返 回 的 输入 流 : 


InputStream is = conn.getInputStream(); 
String result = readData(is, "GBK"); 
conn.disconnect () ; 


在 实现 此 功能 时 ， 必 须要 记得 设置 连接 超时 ， 如 果 网 络 不 好 ，Android 系统 在 超过 默 
认 时 间 后 会 收回 资源 中 断 操 作 。 如 果 返 回 的 响应 码 是 200， 则 标明 成 功 。 利 用 
ByteArrayOutputStream 类 可 以 将 得 到 的 输入 流 写 入 内 存 。 由 此 可 见 ， 在 Android 中 对 文件 
流 的 操作 和 Java SE 中 是 一 样 的 。 

2. 从 Internet 获 取 文件 

利用 HttpURLConnection 对 象 从 网 络 中 获取 文件 数据 的 基本 流程 如 下 。 

(1) 创建 URL 对 象 后 传 入 文件 路 径 : 

URL url = new URL("http://photocdn.sohu.com/20100125/1mg269812337.jpg"); 

(2) 创建 HttpURLConnection 对 象 后 从 网 络 中 获取 文件 数据 : 

HttpURLConnection conn = (HttpURLConnection) url.openConnection(); 

(3) 设置 连接 超时 : 

conn.setConnectTimeout (6* 1000); 

(4) 对 响应 码 进行 判断 : 

if (conn.getResponseCode() !- 200) throw new RuntimeException ("请求 url 失 

W"); 

(5) 得 到 网 络 返 回 的 输入 流 : 

InputStream is = conn.getInputstream(); 

(6) 写 出 得 到 的 文件 流 : 

outstream.write (buffer, 0, len); 

在 实现 此 功能 时 ， 当 对 大 文件 进行 操作 时 需要 将 文件 写 到 SDCard 上 面 ， 而 不 要 直接 
写 到 手机 内 存 上 。 并 且 在 操作 大 文件 时 ， 要 一 边 从 网 络 上 读 ， 一 边 往 SDCard 上 面 写 ， 这 
样 可 以 减少 对 手机 内 存 的 使 用 。 并 且 完 成 功能 时 ， 不 要 忘记 及 时 关闭 连接 流 。 

3. 向 Internet 发 送 请 求 参 数 

利用 HttpURLConnection XJ ¥ [3] Internet 发 送 请 求 参数 的 基本 流程 如 下 。 

(1) 将 地 址 和 参数 存储 到 byte 数组 中 : 

byte[] data = params.toString().getBytes(); 

(2) 创建 URL 对 象 : 


URL realUrl = new URL (requestUrl); 
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(3) 用 HttpURLConnection 对 象 向 网 络 地 址 发 送 请 求 : 

HttpURLConnection conn = (HttpURLConnection) realUrl.openConnection (); 
(4) 设置 允许 输出 : 

conn.setDoOutput (true); 

(5) 设置 不 使 用 缓存 : 

conn.setUseCaches (false); 

(6) 设置 使 用 Post 方式 发 送 : 

conn.setRequestMethod ("POST") ; 

(7) 设置 维持 长 连接 : 

conn.setRequestProperty ("Connection", "Keep-Alive"); 

(8) 设置 文件 字符 集 : 

conn.setRequestProperty ("Charset", "UTF-8"); 

(9) 设置 文件 长 度 : 

conn.setRequestProperty ("Content-Length", String.valueOf (data.length)); 
(10) 设置 文件 类 型 : 


conn.setRequestProperty ("Content-Type", "application/x-www-form- 
urlencoded"); 


(11) 最 后 以 流 的 方式 输出 。 

在 实现 此 功能 时 ， 发 送 Post 请 求 时 必须 设置 允许 输出 。 建 议 不 要 使 用 缓存 ， 避 免 出 现 
不 应 该 出 现 的 问题 。 在 开始 就 用 HttpURLConnection 对 象 的 setRequestProperty0 设 置 ， 即 
生成 HTML 文件 头 。 

4. 向 Internet 发 送 XML 数 据 

XML 格式 是 通信 的 标准 语言 ，Android 系统 也 可 以 通过 发 送 XML 文件 传输 数据 。 实 
现 此 功能 的 基本 流程 如 下 。 

(1) 将 生成 的 XML 文件 写 入 到 byte 数组 中 ， 并 设置 为 UTF-8。 

byte[] xmlbyte = xml.toString().getBytes("UTF-8"); 

(2) 创建 URL 对 象 并 指定 地 址 和 参数 : 


URL url = new 
URL("http://localhost:8080/itcast/contanctmanage.do?method-readxml"); 


(3) 获得 连接 : 
HttpURLConnection conn = (HttpURLConnection) url.openConnection(); 
(4) 设置 连接 超时 : 


conn.setConnectTimeout (6* 1000); 
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(5) 设置 允许 输出 : 

conn.setDoOutput (true); 

(6) 设置 不 使 用 缓存 ; 

conn.setUseCaches(false); 

(1) 设置 以 Post 方式 传输 : 

conn.setRequestMethod ("POST"); 

(8) 维持 长 连接 : 

conn.setRequestProperty ("Connection", "Keep-Alive"); 
(9) 设置 字符 集 : 

conn.setRequestProperty ("Charset", "UTF-8"); 
(10) 设置 文件 的 总 长 度 : 


conn.setRequestProperty ("Content-Length", 
String.valueOf (xmlbyte.length)); 


(11) 设置 文件 类 型 : 
conn.setRequestProperty("Content-Type", "text/xml; charset-UTF-8"); 
(12) 以 文件 流 的 方式 发 送 XML 数据 : 


outStream.write (xmlbyte) ; 


AK 注意 : ”使 用 Android 中 的 HttpURLConnection 时 ， 有 个 地 方 需要 引起 注意 ， 就 是 如 
果 你 的 程序 中 有 跳 转 ， 并 且 跳 转 有 外 部 域名 的 跳 转 ， 那 么 非常 容易 超时 并 抛 
出 域名 无 法 解析 的 异常 (Host Unresolved)， 建 议 做 跳 转 处 理 的 时 候 不 要 使 用 它 
自 带 的 方法 设置 成 为 自动 跟随 跳 转 ， 最 好 自己 做 处 理 ， 以 便 防 止 莫名 其 妙 的 
异常 。 这 个 问题 在 模拟 器 上 面 看 不 出 来 ， 只 有 在 真 机 上 面 才能 看 出 来 。 


4.3.2 ”在 Android 中 使 用 HttpURLConnection 类 

在 编程 时 我 们 无 须 担 心 普通 Java 平台 和 Android 平台 的 差异 ， 我 们 完全 可 以 根据 4.3.1 
节 中 的 知识 在 Android 中 使 用 HttpURLConnection 类 。 

1. 在 手机 屏幕 中 显示 网 络 中 的 指定 图 片 


在 日 常 应 用 中 ， 我 们 经 常 不 需要 将 网 络 中 的 图 片 下 载 在 到 我 们 的 手机 上 ， 只 是 在 网 络 上 
浏览 一 下 。 此 时 我 们 可 以 使 用 HttpURLConnection 类 打开 链接 ， 这 样 就 可 以 获取 连接 数据 了 。 


实 fi 功 能 源码 路 径 


实例 4-5 在 手机 屏幕 中 显示 网 络 中 的 图 片 下 载 路 径 :\daima\4\tu 


在 本 实例 中 ， 使 用 HttpURLConnection 类 连接 并 获取 网 络 中 的 数据 ， 将 获取 的 数据 用 
InputStream( 输 入 流 ) 的 方式 保存 在 记忆 空间 中 。 本 实例 的 具体 实现 流程 如 下 。 
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(1) 编写 布局 文件 main.xml， 


<LinearLayout 
xmlns:android-"http://schemas.android.com/apk/res/android" 
android: background="@drawable/white" 
androi rientation-"vertical" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
> 
<TextView 
android: id="@+id/myTextViewl" 
android: layout_width="fill_ parent" 
android:layout height-"wrap content" 
android:text="@string/app name"/> 
<Button 
android: id="@+id/myButton1" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:text="@string/str buttonl" /> 
<ImageView 
android: id="@+id/myImageView1" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:layout gravity-"center" /> 
</LinearLayout> 


(2) 编写 主 程序 文件 tjava。 首 先 通过 方法 getURLBitmap() 将 图 片 作为 参数 传 入 到 创 
建 的 URL 对 象 ， 然 后 通过 方法 getInputStream() 获 取 连 接 图 的 InputStream. Xf tujava 的 
主要 实现 代码 如 下 : 


public class tu extends Activity 
{ 
private Button mButtonl; 
private TextView mTextViewl; 
private ImageView mImageViewl; 
String uriPic - "http://www.baidu.com/img/baidu sylogol.gif"; 
@override 
public void onCreate (Bundle savedInstanceState) 
{ 
super .onCreate (savedInstanceState) ; 
setContentView (R. layout.main) ; 


要 代码 如 下 : 


mButtonl = (Button) findViewById(R.id.myButtonl); 
mTextViewl = (TextView) findViewById(R.id.myTextViewl); 
mlImageViewl = (ImageView) findViewById (R.id.myImageViewl); 


mButtonl.setOnClickListener(new Button.OnClickListener () 
{ 
Goverride 
public void onClick(View arg0) 
{ 
/* 设置 Bitmap 在 ImageView  */ 


> Andid sssannsma 


mImageViewl . set ImageBitmap (getURLBitmap () ); 
mTextViewl.setText (""); 


public Bitmap getURLBitmap () 
t 
URL imageUrl = null; 
Bitmap bitmap - null; 
try 
t 
/* new URL 对 象 将 网 址 传 入 */ 
imageUrl = new URL(uriPic); 
} 
catch (MalformedURLException e) 
t 
e.printStackTrace(); 


try 
t 
/* 取得 连接 */ 
HttpURLConnection conn - (HttpURLConnection) imageUrl 
-openConnection () ; 
conn.connect () ; 
/* 取得 返回 的 Inputstream */ 
InputStream is = conn.getInputStream(); 
/* 将 InputStream 变 成 Bitmap */ 
bitmap = BitmapFactory.decodeStream(is); 
/* 关闭 InputStream */ 
is.close(); 
) 
catch (IOException e) 
t 
e.printStackTrace(); 
) 
return bitmap; 


) 


执行 后 单 击 “ 单 击 后 获取 网 络 上 的 图 片 ” 按 钮 后 可 以 显示 指定 网 址 的 图 片 ， 如 图 4-6 
所 示 。 


单 击 后 获取 网 络 上 的 图 片 


IDA 
Bai 百度 


46 执行 效果 
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2. 在 手机 屏幕 中 显示 网 页 


在 日 常 应 用 中 ， 我 们 可 以 使 用 HttpURLConnection 类 获取 某 一 个 网 页 的 内 容 。 


实 例 功 能 源码 路 径 
实例 4-6 在 手机 屏幕 中 显 下 载 路 径 :\daima\4\GetHtml 


在 本 实例 中 ， 当 我 们 在 文本 框 中 输入 网 址 并 单 击 “ 显 示 网 页 ”按钮 后 ， 会 获取 文本 杠 
中 的 网 址 ， 打 开 HttpURLConnection 连接 并 获取 输入 流 ， 然 后 将 返回 的 流 保存 为 HTML X 
件 ， 最 后 用 WebView 将 HTML 文件 显示 出 来 。 本 实例 的 具体 实现 流程 如 下 。 

O) 编写 布局 文件 main.xml， 主 要 代码 如 下 : 


«?xml version-"1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="fill parent" 
android:layout height="fill parent" 
2 
<EditText 
android: id="@+id/myEdit1" 
android:layout width="fill parent" 
android:layout height="wrap content” 
android:maxLines="2" 
android:hint=" 请 输入 网 址 " 
/> 
<Button 
android: id="@+id/myButtonl" 
android:layout width="100px" 
android:layout height-"wrap content" 
android:text-" WW yi" 
/> 
<WebView 
android: id="@+id/myWeb1" 
android:layout width="fill parent" 
android:layout height="wrap content" 
android:minHeight="200px" 
/> 
</LinearLayout> 


(2) 编写 主 程序 文件 GetHtmljava , 4E Jj ik getStaticPageByBytes() 中 通 过 
HttpURLConnection 来 获取 某 一 个 网 页 的 内 容 。 文 件 GetHtml java 的 具体 实现 代码 如 下 


package ckl.gethtml; 


import java.io.File; 

import java.io.FileOutputStream; 
import java.io.IOException; 

import java.io.InputStream; 

import java.net.HttpURLConnection; 
import java.net.MalformedURLException; 
import java.net.URL; 
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import android.app.Activity; 

import android.os.Bundle; 

import android.util.Log; 

import android.view.View; 

import android.view.View.OnClickListener; 
import android.webkit.WebView; 

import android.widget.Button; 

import android.widget.EditText; 


public class GetHtml extends Activity ( 
private EditText mEdit - null; 
private Button mButton null; 
private WebView mWeb = null; 


public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView(R.layout.main); 


mEdit = (EditText)findViewById(R.id.myEditl); 
mButton = (Button) findViewById (R.id.myButtonl); 
mWeb = (WebView)findViewById (R.id.myWebl); 


mWeb.getSettings().setJavaScriptEnabled (true); 
mWeb.getSettings().setPluginsEnabled (true); 


mButton.setOnClickListener(new OnClickListener() { 
public void onClick(View v) { 
String strUrl = mEdit.getText() .toString(); 
String strFile = "/sdcard/test.html"; 
if (!strUrl.startsWith("http://")) { 
stron! = “http://" + struril, 
} 
getStaticPageByBytes (strUrl, strFile); 
mWeb.loadUrl("file://" + strFile); 


); 


private void getStaticPageByBytes(String surl, String strFile)( 
Log.i("getStaticPageByBytes", surl + ", " + strFile); 


HttpURLConnection connection - null; 
InputStream is = null; 


File file - new File(strFile); 
FileOutputStream fos = null; 


try ( 
URL url - new URL(surl); 
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connection = (HttpURLConnection)url.openConnection(); 


int code = connection.getResponseCode () ; 
if (HttpURLConnection.HTTP OK == code) ( 
connection.connect () ; 
is = connection.getInputStream(); 
fos = new FileOutputStream(file); 


int de 

while((i = is.read()) != -1){ 
fos.write (i); 

} 


is.close(); 
fos.close(); 
} 
} catch (MalformedURLException e) { 
e.printStackTrace(); 
) catch (IOException e) ( 
e.printStackTrace(); 
) finally ( 
if (connection !- null) ( 
connection.disconnect (); 
) 


) 
执行 后 的 效果 如 图 4-7 所 示 。 
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图 4-7 执行 效果 


注意 : 本 实例 的 做 法 并 不 能 每 次 都 保证 可 以 获得 正确 的 网 页 内 容 ， 主 要 是 因为 受到 
网 页 内 容 编码 (Encoding) 的 影响 ， 页 面 编 码 内 容 的 编码 是 不 确定 的 ， 可 能 不 
是 UTF-8。 因 为 在 Java 内 部 是 使 用 UTF-16 来 表示 字符 的 ， 所 以 在 使 用 
String 保存 页 面 内 容 时 ， 会 被 转换 为 UTF-16 来 保存 ， 写 入 文件 时 再 转换 为 操 
作 系统 中 的 默认 编码 ， 这 样 导 致 保存 文件 内 容 的 编码 和 html 中 指定 的 编码 不 
一 致 ， 导 致 中 文 乱码 。 
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Android 手机 系统 功能 十 分 强大 ， 开 发 人 员 可 以 在 上 面 开 
发 出 功能 强大 的 应 用 程序 。 在 众多 网 络 应 用 中 ， 网 页 项 目 将 成 
为 现 阶 段 一 个 新 兴 的 热点 ， 所 以 很 有 必要 专门 开发 能 
Android 手机 上 浏览 的 网 页 。 其 实 本 书 前 面 所 讲解 的 HTML. 
CSS. JavaScript 都 是 网 页 开发 技术 ， 用 这 三 种 技术 开发 的 网 页 
能 够 在 手机 屏幕 上 正常 浏览 吗 ? 答案 是 肯定 的 ， 但 是 前 提 是 需 
要 进行 一 些 变动 。 本 章 将 详细 讲解 为 Android 开发 HTML 网 页 
的 方法 。 
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开发 人 员 都 很 希望 用 HTML. CSS 和 JavaScript 技术 来 构建 适应 于 Android 系统 的 应 
用 程序 。 这 个 旅程 的 第 一 步 是 为 HTML 添加 有 亲和力 的 样式 ， 使 它们 更 像 移动 应 用 程序 。 
在 实现 这 个 功能 的 时 候 ， 我 们 将 CSS 样式 应 用 到 传统 的 HTML 网 页 上 ， 让 它们 在 Android 
手机 上 正常 浏览 ， 并 且 很 容易 浏览 。 


5.1.1 搭建 开发 环境 


在 开发 能 够 在 Android 手机 运行 的 网 页 工作 之 前 ， 首 先 需 要 有 一 个 Web 空间 。 这 个 空 
间 的 作用 是 ， 将 我 们 开发 的 网 页 上 传 到 这 个 空间 ， 然 后 就 可 以 在 Android 模拟 器 中 浏览 该 
网 页 了 ， 这 样 就 实现 了 测试 网 页 的 目的 。 可 能 有 的 读者 有 自己 的 Web 空间 ， 如 果 没 有 也 不 
要 紧张 ， 可 以 免费 申请 一 个 空间 。 很 多 网 站 提供 了 免费 空间 服务 ， 如 http://www.3v.cm/。 
申请 免费 空间 的 基本 流程 如 下 。 

(1) 登录 http:/www.3vcm/， 如 图 5-1 所 示 。 


主页 列表 VK — 友情 链接 
> ”您 当前 的 位 置 : 免费 空间 -> 首页 


| 
ee 
用 户 名 :| » 喜讯 : 免费 空间 开局 二 闻 域 名 功能 (2011-8-27) 
LLL NR pyg | EU eRe teann (2008-6-28) ED 
mm: ， Wi: 免费 空间 用 户 加 何 开通 收费 空间 (2010-6-3) — 
Cookie: ARF E " 
z » Wi: 免费 裤 间 如 何 上 传 文件 
DEn e, ME: 我 司 免费 空间 介绍 及 申请 方法 ETT 
; - vai: i 2010-5-25) 
SEENT CEN 网 站 简介 : 在 此 输入 您 的 网 
» Wi MTA Prorat (2010-4-27】 站 简介 

C 共有 注册 会 员 : 217082 dmg: 


c 今天 注册 会 员 : 678 
O 当前 在 贱 会 员 : 14524 — 
c REMAR: Wd ©, umo mx 搜索 


图 5-1 登录 http://Wwww.3v.cm/ 


(2) 单 击 图 5-1 左 侧 的 “注册 ”按钮 ， 进 入 “服务 条 款 ” 页 面 ， 如 图 5-2 所 示 。 

(3) 单 击 “ 我 同意 ”按钮 ， 注 入 填写 用 户 名 页 面 ， 如 图 5-3 所 示 。 

(4) 填写 完 用 户 名 后 单 击 “ 下 一 步 ” 按 钮 ， 进 入 填写 注册 信息 页 面 ， 如 图 5-4 所 示 。 

(5) 填写 完 注册 信息 后 单 击 “ 递 交 ” 按 钮 完成 注册 。 在 注册 中 心 页 面 我 们 可 以 管理 自 
己 的 空间 ， 如 图 5-5 所 示 。 
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多 和 区 
欢迎 您 申请 使 用 三 锥 免费 个 人 主页 宝 间 服 务 ， 为 维护 网 上 公共 秩序 和 社会 稳定 ,请 您 自觉 得 守 以 下 条 款 : 


一 、 不 宰 利 用 本 站 危害 国家 安全 、 袖 医 国 家 秘密 ,不 得 侵犯 国家 社会 集体 的 和 公民 的 合法 权 茵 ， 不 得 利用 本 站 制作 、 复 制 和 传播 下 列 信 
息 : 


( 一 ) 炉 动 抗拒 、 破 坏 完 法 和 法 律 、 行 政法 规 实施 的 ; 

(=) 煽动 颜 履 国家 政权 ， 推 基 社 会 主义 制度 的 

( 三 ) 护 动 分 裂 国家、 破坏 国家 统一 的 ; 

《 四) 炉 动 民族 仇恨 、 民 族 岐 视 ， 破 坏 民族 团结 的 

CH) 捏造 或 者 焉 曲 事实 ， 散布 证 言 ， 扰 乱 社 会 秩序 的 

CAO EISSHESRE. HO. GU. RED. BH. Duk. Bim. (usq: 
CE DAHA REREAD, RMT EU RO ; 
CAO IBEBURULAS IR SH 7 

CAL) 其 他 违反 完 法 和 法 健行 政法 规 的 ; 


二 、 互 相 尊 重 ， 对 自己 的 言论 和 行为 负责 。 


ine | 


图 5-2 服务 条 款 页 面 
(aas. cann 


BP&: [+ 检测 用 户 各 | 使 用 3-12 个 英文 字母 或 数字 或 -， 可 任意 组 侣 ) 
SARE: [免费 空间 -100i0 € | — jc o cia imeem 


下 -- 步 


图 5-3 填写 用 户 名 页 面 


帐号 信息 
用 户 名 : qqdsadsad 
密码 安全 性 
密码 :|  —— —— «Cen, ESX4A8) 
BAS: [Og 
密码 问题 : | o —— — (mn fim 
BSR: | —— s (RR) 
基本 资料 


4 务必 使 用 I 下 浏览 器 ， 否 则 有 可 能 无 法 正常 显示 


*( 用 来 接收 您 的 帐号 信息 及 密码 ) 


网 站 信息 
网 站 名 称 * 
网 站 分 类 : [REE wj. 
ERRAZA B 
网 站 介绍 : 
E] egora» 
Mina: 79 08 (xig, exes? ESSIN 
wz | zu] 


5-4 ”填写 注册 信息 页 面 


= : Android parsans 


Ei | > ROEREROO. 今天 是 : 2011 年 10 月 12 日 BME 
easa 30 [2010-7-30 15:33:21] MB: SRSA LEL | 
«PR 虚拟 主机 控制 面板 
Ld ”您 可 以 自由 操作 您 的 虚拟 主机 
Ld 
zit rr 
zons «PB: WR: VOTE MR: vot 
Tk PRA: AR: 08 MR o 

BPRS: 免费 用 户 ROIMRAP RESaTaSS 
M saan: saaa 
Me sasa: 1008 
nnm amam: 2011-10-12 
emus: oT] 
Lh aum: 3 
WAYS E s 2011-10-12 19:17:35 
—— taar: 124.128. 128.52 
Bm: 1223 
在 二 充值 
网 站 域 各: Mtpi// ree net 
namu 
则 务 记录 
jum 


图 5-5 用 户 中 心 页 面 


(6) 单 击 图 5-5 左 侧 的 “FTP 管理 ”链接 可 以 更 改 我 们 的 FTP 密码 ， 并 且 可 以 查看 我 
们 空间 的 他 地址 ， 如 图 5-6 所 示 。 


FEES: 221.1.217 92 


用 户 各 
sese 
wem: [  — —  — + S^etr 
muse: [ ` 
msj 
图 5-6 FTP 管理 


根据 图 5-6 中 的 资料 我 们 可 以 用 专业 上 传 工具 上 传 我 们 编写 的 程序 文件 。 
(7) 单 击 图 5-5 左 侧 的 “文件 管理 ”链接 ， 在 弹出 的 页 面 中 可 以 在 线 管理 我 们 空间 
的 文件 ， 如 图 5-7 所 示 。 


当前 位 置 ; |/ enanaijiney ESTEN] E 
ZijsRR| MALF) MERR) 。 三 达 文件 | Mine] HEX | 
Botte OMAMA 13, E-X,T-E nue [18] 页 


TZ) images RS We Edi et X^ HH 
共 1 个 目录 


g 


psstore ns sron d RE ATE MBN RS 6.001 2011-10-12 18:44:20 


JScript Seript xi RHE WS MA E 10.40 mw 2011-10-12 10:44:10 
a pag [= FG EER sus 改 各 HER BE 6T 2011-10-12 19:06:40 
D darii pasera SERA MSEE Ler 2011-10-12 18:44:15 
Do Blase js script seine 文件 HES HER BE cie 字 节 2011-10-12 18:4414 
D oe soe [Pores ee Si BS WBE ewm 2010-9-17 8:12:46 
CO Master ess PARTETA SERS MR BE 1:3 于 节 2011-10-12 18:44:13 
Dosage -x+ Batt REGS BEBE OSB 2011-10-12 16:44:12 
D 2) inden hial ATIL Docoment SE AS MBE BE 2.8 00 2011-10-12 18:43:51 
DAFA: 100, BREA: 10173 KB BAAR: 共 9 个 文件 的 92.47 mw 


ARDIA MOSA 1004-2005 A1 Rigàts Recervsd wsbeacterdSvidee cn 
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单 击 图 5-7 中 每 一 个 文件 的 “路 径 ” 链 接 ， 可 以 获取 该 文件 的 URL 地 址 ， 这 样 我 们 在 


Android 手机 


效果 。 


就 可 以 用 这 个 URL 来 访问 此 文件 ， 查 看 此 文件 在 Android 手机 中 的 执行 


5.1.2 简单 网 页 开发 


下 面 我 们 以 一 个 具体 例子 来 作为 开始 。 本 实例 使 用 HTML 和 CSS 技术 实现 了 4 个 简 


单 的 网 页 。 
实例 功 能 源码 路 径 
实例 5-1 编写 一 个 适用 于 Android 系统 的 网 页 下 载 路 径 \daima\5\first — | 


主页 文件 index.html 的 源 代码 如 下 : 


<html> 
«head 


> 


<title>aaa</title> 
<link rel="stylesheet" href="desktop.css" type="text/css" /> 


<body: 


> 


<div id="container"> 


<div id="header"> 
<hl><a href=" ./">AAAA</a></hl> 
<div id="utility"> 
<ul> 
<li><a href="about .html"> 关 于 我 们 </a></1i> 
<li><a href="blog.html"> 博 客 </a></1i> 
<li><a href="contact .html"> 联 系 我 们 </a></1i> 
</ul> 
</div> 
<div id="nav"> 
<ul> 
<li><a href="bbb.html">Android 之 家 </a></1i> 
<li><a href="ccc.html"> 电 话 支 持 </a></1i> 
<li><a href="dqdd.html"> 在 线 客服 </a></1i> 
«li»«a href="http://www.aaa.com"> 在 线 视频 </a></1i> 
«/ul» 
«/div» 
«/div» 
<div id="content"> 
<h2>About</h2> 
<p> 欢 迎 大 家 学 习 RAndroid， 都 说 这 是 一 个 前 途 辉 煌 的 职业 ， 我 也 是 这 么 认为 
的 ， 希 望 事 实 如 此 - - . .</p> 
</div> 
«div id="sidebar"> 
«img alt=" H" src="aaa.png"> 
<p> 欢 迎 大 家 学 习 RAndroid， 都 说 这 是 一 个 前 途 辉 煌 的 职业 ， 我 也 是 这 么 认为 
的 ， 希 望 事 实 如 此 . - . .</p> 
«/div» 
«div id="footer"> 


> Andicid sss nsa 


«ul» 
<li><a href-"bbb.html"»Services«/a»«/li» 
<li><a href-"ccc.html"»About«/a»«/li» 
<li><a href-"ddd.html"»Blog«/a»«/li» 
«/ul» 
«p class="subt le"> iil n /p» 
«/div» 
«/div» 
</body> 
</html> 
根据 “样式 和 表现 想 分 离 ” 的 原则 ， 我 们 需要 单独 写 一 个 CSS 文件 ， 通 过 这 个 CSS 
文件 来 给 上 述 这 个 网 页 进行 修饰 ， 修 饰 的 最 终 目 的 是 能 够 在 Android 手机 上 进行 浏览 。 
T E: 在 实际 开发 应 用 中 ， 最 好 将 桌面 浏览 器 的 样式 表 和 Android 样式 表 划 清 界 
限 。 根 据 笔 者 的 经 验 ， 写 两 个 完全 独立 的 文件 会 舒服 很 多 。 当 然 还 有 另 一 种 
做 法 是 把 所 有 的 CSS 规则 放 到 一 个 单一 的 样式 表 中 ， 但 是 这 种 做 法 不 值得 提 
倡 ， 具 体 原 因 有 以 下 两 点 。 
O 文件 太 长 了 就 显得 麻烦 ， 不 利于 维护 。 
O 把 太 多 不 相关 的 桌面 样式 规则 发 送 到 手机 上 ， 将 会 浪费 一 些 宝贵 的 带宽 
和 存储 空间 。 
开始 写 CSS 文件 。 为 了 适应 Android 系统 ， 编 写 下 面 的 link 标签 。 
«link rel-"stylesheet" type-"text/css" 
href-"android.css" media-"only screen and (max-width: 480px)" /» 
«link rel-"stylesheet" type-"text/css" 
href-"desktop.css" media-"screen and (min-width: 481px)" /» 
在 上 述 代码 中 ， 最 明显 的 变动 是 浏览 器 宽度 的 变化 ， 即 : 
max-width: 480px 
min-width: 481px 
这 是 因为 手机 屏幕 的 宽度 和 电脑 屏幕 的 宽度 是 不 一 样 的 (当然 长 度 也 不 一 样 ， 但 是 都 具 
有 下 拉 功 能 )，480 是 Android 系统 的 标准 宽度 ， 上 述 代码 的 功能 是 不 管 浏览 器 的 窗口 是 多 
大 ， 桌 面 用 户 看 到 的 都 是 文件 desktop.css 中 样式 修饰 的 页 面 ， 宽 度 都 是 用 如 下 代码 设置 的 
max-width: 480px 
min-width: 481px 
上 述 代码 中 有 以 下 两 个 CSS 文件 。 
Q  desktop.ss 文件 : 该 文件 是 在 开发 电脑 页 面 时 编写 的 样式 文件 ， 就 是 为 这 个 
HTML 页 面 服务 的 。 
Q android.css “fF: 该 文件 是 一 个 新 文件 ， 也 是 本 章 将 要 讲解 的 重点 ， 通 过 该 文 
件 ， 可 以 将 上 面 的 电脑 网 页 显示 在 Android 手机 中 。 当 读者 开发 出 完整 的 
android.css 后 ， 可 以 直接 在 HTML 文件 中 将 如 下 代码 删除 ， 就 不 再 用 这 个 修饰 文 
件 了 。 
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«link rel-"stylesheet" type-"text/css" 
href-"desktop.css" media-"screen and (min-width: 481px)" /» 


此 时 在 Chrome 浏览 器 浏览 修改 后 的 HTML 文件 ， 无 论 从 Android 手机 浏览 器 还 是 
脑 浏 览 器 ， 执 行 后 都 将 得 到 一 个 完整 的 页 面 展示 。 完 整 代码 如 下 : 


«html» 
«head» 

<title>AAAA</title> 

<link rel="stylesheet" type="text/css" href="android.css" 
media-"only screen and (max-width: 480px)" /> 

«link rel-"stylesheet" type-"text/css" href-"desktop.css" 
media-"screen and (min-width: 481px)" /» 

cnet agas 


此 


stylesheet" type="text/css" href-"explorer.css" 
LLKS 


<! [endif] --> 
<script type="text/javascript" src="jquery.js"></script> 
<script type="text/javascript" src="android.js"></script> 
<meta http-equiv="Content-Type" content="text/html; charset=gb2312"> 
</head> 
<body> 
<div id="container"> 
<div id="header"> 
<hl><a href-"./"»AAAA«/a»«/hl» 
<div id="utility"> 
<ul> 
<li><a href="about .html"> 关 于 我 们 </a></1i> 
<li><a href="blog.html"> 博 客 </a></1i> 
<li><a href="contact .html"> 联 系 我 们 </a></1i> 
</ul> 
</div> 
<div id="nav"> 
<ul> 
<li><a href="bbb.html">Android 之 家 </a></1i> 
<li><a href="ccc.html"> 电 话 支 持 </a></1i> 
<li><a href="ddd.html"> 在 线 客服 </a></1i> 
<li><a href="http://www.aaa.com"> 在 线 视频 </a></1i> 
«/ul» 
«/div» 
«/div» 
<div id="content"> 
<h2>About</h2> 
<p> 欢 迎 大 家 学 习 Android， 痢 说 这 是 一 个 前 途 辉 煌 的 职业 ， 我 也 是 这 么 认为 
的 ， 希 望 事实 如 此 ... .</p> 
</div> 
<div id="sidebar"> 
«img alt=" 好 图 片 " src="aaa.png"> 
<p> 欢 迎 大 家 学 习 RAndroid， 都 说 这 是 一 个 前 途 辉 煌 的 职业 ， 我 也 是 这 么 认为 
W, PARKU... .</p> 
</div> 
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<div id="footer"> 
<ul> 
<li><a href-"bbb.html"»Services«/a»«/li» 
<li><a href-"ccc.html"»About«/a»«/li» 
<li><a href-"ddd.html"»Blog«/a»«/li» 
</ul> 
«p class="subtle"> iii mic /p» 
«/div» 
«/div» 
</body> 
</html> 
</html> 


desktop.css 文件 的 代码 如 下 : 


For example: 
body ( 

margin:0; 

padding:0; 

font: 75$ "Lucida Grande", "Trebuchet MS", Verdana, sans-serif; 
} 


执行 效果 如 图 5-8 所 示 。 


AAAA 


。 关于 我 们 
* ee 
。 联系 我 们 


© Android 之 家 
* 电话 支持 


欢迎 大 家 学 习 Android , 885332 —  RISTSISRURR E ， 我 也 是 这 么 认为 的 ， 需 望 事实 如 此 … .. 
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欢迎 大 家 学 习 Android , BiiRS— NAA , SEEOISTXAUUGBU , PAET. 
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图 5-8 执行 效果 


5.1.3 ”控制 页 面 的 缩放 


除非 我 们 明确 告诉 Android 浏览 器 ， 否 则 它 会 认为 页 面 宽度 是 980px。 当 然 这 在 大 多 
数 情 况 下 能 工作 得 很 好 ， 因 为 电脑 已 经 适应 了 这 个 宽度 。 但 是 如 果 针 对 小 尺寸 屏幕 的 
Android 手机 的 话 ， 我 们 必须 做 一 些 调整 ， 需 要 在 HTML 文件 的 head 元 素 中 加 一 个 
viewport 元 标签 ， 让 移动 浏览 器 知道 屏幕 的 大 小 。 
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«meta name-"viewport" content-"user-scalable-no, width-device-width" /> 


这 样 就 实现 了 屏幕 的 自动 缩放 ， 可 以 根据 显示 屏 的 大 小 带 给 我 们 不 同 大 小 的 显示 页 
面 。 读 者 无 须 担心 加 上 viewport 后 在 电脑 上 的 显示 影响 ， 因 为 桌面 浏览 器 会 忽略 viewport 
元 标签 。 

如 果 不 设置 viewport 的 宽度 ， 页 面 在 加 载 后 会 缩小 。 我 们 不 知道 缩放 的 大 小 是 多 少 ， 
因为 Android 浏览 器 的 设置 项 允许 用 户 设置 默认 缩放 大 小 ， 选 项 有 大 、 中 (默认 )、 小 。 即 
使 设置 过 viewport 宽度 ， 这 个 设置 项 也 会 影响 页 面 的 缩放 大 小 。 


5.2 为 Android 中 的 网 页 添加 CSS 样式 


我 们 接着 上 一 节 的 演示 代码 继续 讲解 。 前 面 代码 中 的 android.css 文件 一 直 没 用 ， 下 面 
将 开始 编写 这 个 文件 ， 目 的 是 使 我 们 的 网 页 在 Android 手机 上 完美 并 优越 显示 。 


5.2.1. 编写 基本 样式 


所 谓 的 基本 样式 是 指 诸如 背景 颜色 、 字 体 大 小 、 字 体 颜色 等 样式 ， 在 上 一 节 实 例 的 基 
础 上 继续 扩展 ， 看 下 面 的 具体 实现 流程 。 

(1) 在 android.css 文件 中 设置 <body> 元 素 的 如 下 基本 样式 。 

body ( 


background-color: #ddd; /* 背景 颜色 */ 

color: $222; /* 字体 颜色 */ 

font-family: Helvetica; /* 字体 */ 

font-size: 14px; /* 字体 大 小 */ 

margin: 0; /* 外 边 距 */ 

padding: 0; /* 内 边 距 */ 
} 


(2) 开始 处 理 <header> 中 的 <div> 内 容 ， 它 包含 主要 入 口 的 链接 (也 就 是 logo) 和 一 级 、 
二 级 站 点 导航 。 第 一 步 是 把 logo 链接 的 格式 调整 得 像 可 以 点 击 的 标题 栏 ， 在 此 我 们 将 下 面 
的 代码 加 入 到 android.css 文件 中 。 


#header hl { 
margin: 0; 
padding: 0; 

} 

#header hl a { 
background-color: #ccc; 
border-bottom: lpx solid #666; 
color: #222; 
display: block; 
font-size: 20px; 
font-weight: bold; 
padding: 10px 0; 
text-align: center; 
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text-decoration: none; 
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G) 用 同样 的 方式 格式 化 一 级 和 二 级 导航 的 <ul> 元 素 。 在 此 只 需 用 通用 的 标签 选择 器 
(也 就 是 如 eader uD) 就 够 用 了 ， 而 不 必 再 设置 标签 <ID>， 也 就 不 必 设置 诸如 下 面 的 样式 了 。 


Q  £header ul 
Q #utility 

Q #header ul 
Q nav 


实现 此 过 程 的 代码 如 下 : 


#header ul { 
list-style: none; 
margin: 10px; 
padding: 0; 

} 

#header ul li a ( 
background-color: #FFFFFF; 
border: lpx solid #999999; 
color: #222222; 
display: block; 
font-size: 17px; 
font-weight: bold; 
margin-bottom: -lpx; 
padding: 12px 10px; 
text-decoration: none; 

} 


(4) 为 content 和 sidebar div 加 内 边 距 ， 使 文字 到 屏幕 边缘 之 间 有 空 的 距离 。 代 码 
如 下 。 
#content, #sidebar { 
padding: 10px; 
} 
(5) 设置 <footer> 中 内 容 的 样式 ，<footer> 里 面 的 内 容 比 较 简单 ， 我 们 只 需 将 display 设 
置 为 none， 代 码 如 下 : 


#footer { 
display: none; 
H 


此 时 将 上 述 代码 在 电脑 中 执行 的 效果 如 图 5-9 所 示 。 
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欢迎 大 家 学 习 Android ,都 说 这 是 一 个 区 途 糙 烛 的 职业 ， 我 也 是 这 么 认为 的 ， 知 望 事 详 如 此 … 
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图 5-9 电脑 中 的 执行 效果 
在 Android 模拟 器 中 的 执行 效果 如 图 5-10 所 示 。 


About 


欢迎 大 家 学 习 Androld , S882 88 —7- 186g 
的 职业 ， 我 也 是 这 么 认为 的 ， 希 望 杏 实 如 此 -… 
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欢迎 大 家 学 习 Androld , WULE- MME 
的 职业 ， 我 也 是 这 么 认为 的 ， 柄 望 票 实 如 此 .… 


图 5-10 在 Android 中 的 执行 效果 
因为 添加 了 自动 缩放 ， 并 且 添 加 了 修饰 Menu 的 样式 ， 所 以 整个 界面 看 上 去 很 美 。 
5.2.2 ”添加 视觉 效果 


为 了 使 我 们 的 页 面 变 得 精彩 ， 我 们 可 以 尝试 加 一 些 充满 视觉 效果 的 样式 。 
(1) 给 <header> 文 字 加 lpx 向 下 的 白色 阴影 ， 背 景 加 上 CSS 渐变 效果 。 具 体 代码 
如 下 : 


#header hl a { 
text-shadow: Opx lpx lpx #fff; 
background-image: -webkit-gradient (linear, left top, left bottom, 
from(#ccc), to(#999)); 
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对 于 上 述 代 码 有 两 点 说 明 。 
Q textshadow 声明 : 参数 从 左 到 右 分 别 表示 水 平 偏 移 、 垂 直 偏 移 、 模 糊 效果 和 颜 
色 。 在 大 多 数 情况 下 ， 可 以 将 文字 设置 成 上 面 代 码 中 的 数值 ， 这 在 Android 界面 
中 的 显示 效果 也 不 错 。 在 大 部 分 浏览 器 上 ， 将 模糊 范围 设置 为 0px 也 能 看 到 效 
果 。 但 Android 要 求 模 糊 范围 最 少 是 lpx， 如 果 设 置 成 0px， 在 Android 设备 上 将 
显示 不 出 来 文字 阴影 。 
ū -webkit-gradient: 功能 是 让 浏览 器 在 运行 时 产生 一 张 渐变 的 图 片 。 因 此 ， 可 以 把 
CSS 渐变 功能 用 在 任何 平常 指定 图 片 (比如 背景 图 片 或 者 列表 式 图 片 )URL 的 地 
Ji. 参数 从 左 到 右 的 排列 顺序 分 别 是 ， 渐变 类 型 (可 以 是 linear 或 者 radial 的 )、 渐 
变 起 点 (可 以 是 left top. left bottom, right top 或 者 right bottom)、 渐 变 终点 、 起 点 
I 注意 :在 上 述 赋值 中 不 能 颠倒 描述 渐变 起 点 、 终 点 常量 (left top. left bottom, right 
top. right bottom) 的 水 平和 垂直 顺序 。 也 就 是 说 ，top left. bottom left. top 
right 和 bottom right 是 不 合法 的 值 。 
(2) 为 导航 菜单 加 上 圆 角 样式 ， 代 码 如 下 : 


#header ul li:first-child a ( 
-webkit-border-top-left-radius: 8px; 
-webkit-border-top-right-radius: 8px; 


f! 

#header ul li:last-child a { 
-webkit-border-bottom-left-radius: 8px; 
-webkit-border-bottom-right-radius: 8px; 

} 


上 述 代 码 使 用 -webkit-border-radius 属性 描述 角 的 方式 ， 定 义 列表 第 一 个 元 素 的 上 两 个 
角 和 最 后 一 个 元 素 的 下 两 个 角 是 以 8 像素 为 半径 的 圆 角 。 此 时 在 Android 中 的 执行 效果 如 
图 5-11 所 示 。 


关于 我 们 


博客 
联系 我 们 


Android 之 家 


5-11 在 Android 中 的 执行 效果 
此 时 会 发 现 列表 显示 样式 变 为 了 圆 角 样式 ， 整 个 外 观 显得 更 加 圆滑 和 自然 。 
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5.3 76 Android P ri ds20 JavaScript 特效 


经 过 前 面 的 步骤 ， 一 个 基本 的 HTML 页 面 就 设计 完成 了 ， 并 且 这 个 页 面 可 以 在 
Android 手机 上 完美 显示 。 为 了 使 页 面 更 加 完美 ， 接 下 来 的 内 容 中 ， 我 们 将 详细 讲解 在 上 
述 页 面 中 添加 JavaScript 行为 特效 的 基本 知识 。 


5.3.1 jQuery 框架 介绍 


jQuery 是 继 prototype 之 后 又 一 个 优秀 的 JavaScript 框架 。jQuery 是 一 个 轻 量 级 的 js 
E, ERA 21KB. jQuery 不 但 兼容 CSS 3， 而 且 还 兼容 各 种 浏览 器 。jQuery 不 但 使 
用 户 可 以 更 方便 地 处 理 HTML Documents, Events 和 动画 元 素 ， 并 且 方 便 地 为 网 站 提供 
Ajax ZH.. jQuery 还 有 一 个 比较 大 的 优势 是 ， 它 的 文档 说 明 很 全 ， 而 且 各 种 应 用 也 说 得 很 
详细 ， 同 时 还 有 许多 成 熟 的 插件 可 供 选择 。jQuery 能 够 使 用 户 的 HTML 页 保持 代码 和 
HTML 内 容 分 离 ， 也 就 是 说 ， 不 用 再 在 HTML 里 面 插入 一 堆 js 来 调用 命令 了 ， 只 需 定义 
id 即 可 。 

1.jQuery 的 语法 

jQuery 是 为 HTML 元 素 的 选取 编制 的 ， 通 过 jQuery 可 以 对 HTML 元 素 执行 某 些 操 
作 。 使 用 jQuery 的 基础 语法 格式 如 下 : 

$ (selector).action() 

O ”美元 符号 : 定义 jQuery. 

O ”选择 符 (selector): “查询 ”和 “查找 ” HTML 元 素 。 

口 *jQuery 的 action: 执行 对 元 素 的 操作 。 


例如 下 面 的 代码 : 
$ (this).hide() // 隐 藏 当前 元 素 
$ ("p") .hide() // 隐 藏 所 有 段落 


$("p.test").hide() // 隐 藏 所 有 class-"test" 的 段落 
$("#test") .hide () — // 隐 藏 所 有 id="test" 的 元 素 


2. jQuery 的 简单 使 用 
下 面 通过 如 下 代码 来 让 读者 认识 jQuery 的 强大 功能 。 


<html> 
<head> 
<script type-"text/javascript" src="/jquery/jquery.js"></script> 
<script type="text/javascript"> 
$ (document) . ready (function () { 

$ ("button") .click (function () { 

$("#test") -hide(); 
he 
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5; 
</script> 
</head> 


<body> 

<h2>This is a heading</h2> 

<p>This is a paragraph.</p> 

<p id="test">This is another paragraph.</p> 
<button type="button">Click me</button> 
</body> 


</html> 

上 述 代 码 演示 了 jQuery 中 函数 hide0) 的 基本 用 法 ， 功 能 是 隐藏 当前 的 HTML 7638. JA 
行 效果 如 图 5-12 所 示 ， 只 显示 一 个 按钮 。 单 击 该 按钮 后 ， 会 隐藏 所 有 的 HTML 元 素 ， 包 
括 这 个 按钮 ， 此 时 页 面 一 片 空白 。 


Click me 


图 5-12 未 被 隐藏 时 
SAGER: ”本 书 的 重点 不 是 jQuery， 所 以 不 再 对 其 使 用 知识 进行 讲解 。 读 者 可 以 参阅 其 
他 书籍 或 网 上 教程 来 学 习 它 。 


5.3.2 ”具体 实践 


本 小 节 继 续 以 前 面 的 实例 5-1 为 基础 。 下 面 步骤 的 目的 是 为 页 面 添加 一 些 JavaScript 
元 素 ， 让 页 面 支 持 一 些 基 本 的 动态 行为 。 在 具体 实现 的 时 候 ， 使 用 了 jQuery 框架 。 具 体 要 
做 的 是 ， 让 用 户 控制 是 否 显示 页 面 顶部 那个 太 引 人 注目 的 导航 栏 ， 这 样 用 户 可 以 只 在 想 看 
的 时 候 去 看 。 我 们 的 实现 流程 如 下 。 

(1) 隐藏 <header> 中 的 ul 元 素 ， 让 它 在 用 户 第 一 次 加 载 页 面 之 后 不 会 显示 出 来 。 有 具体 
代码 如 下 : 

#header ul. hide( 


display: none; 


) 
Q) 定义 显示 和 隐藏 菜单 的 按钮 ， 代 码 如 下 : 


«div class="leftButton"onclick="toggleMenu () ">Menu< / div» 


我 们 定义 一 个 带 有 leftButton 类 的 div 元 素 ， 将 其 放 在 header 里 面 。 下 面 是 这 个 按钮 
的 完整 CSS 样式 代码 : 


#header div.leftButton { 
position: absolute; 
top: 7px; 

"etti 6px; 
height: 30px; 
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font-weight: bold; 

text-align: center; 

color: white; 

text-shadow: rgba (0,0,0,0.6) Opx -lpx 1px; 
line-height: 28px; 

border-width: 0 8px 0 8px; 

-webkit-border-image: url(images/button.png) 0 8 0 8; 


5 

上 述 代 码 的 具体 说 明 如 下 。 

Q position: absolute: 从 顶部 开始 ， 设 置 position 为 absolute， 相 当 于 把 这 个 div 元 素 
从 HTML 文件 流 中 去 掉 ， 从 而 可 以 设置 自己 的 最 上 面 和 最 左面 的 坐标 。 

O height: 30px: 设置 高 度 为 30px。 

Q font-weightbold: 定义 文字 格式 为 粗 体 ， 白 色 带 有 一 点 向 下 的 阴影 ， 在 元 素 里 居 
中 显示 。 

口 text-shadow:rgba: rgb(255,255,255). rgb(100%,100%,100%) i x MIHFFFFFF 格式 是 
一 个 原理 ， 都 是 设置 颜色 值 的 。 在 rgba0 函 数 中 ， 它 的 第 4 个 参数 用 来 定义 Alpha 
值 (透明 度 )， 取 值 范围 从 0 一 1。 其 中 0 表示 完全 透明 ，1 表示 完全 不 透明 ，0 一 1 
之 间 的 小 数 表示 不 同 程度 的 半 透 明 。 

口 line-height: 把 元 素 中 的 文字 往 下 移动 的 距离 ， 使 之 不 会 和 上 边框 齐 平 。 

口 ”border-width 和 -webkit-border-image: 这 两 个 属性 一 起 决定 把 一 张 图 片 的 一 部 分 放 
入 某 一 元 素 的 边框 中 去 。 如 果 元 素 大 小 由 于 文字 的 增 减 而 改变 ， 图 片 会 自动 拉 伸 
以 适应 这 样 的 变化 。 这 一 点 其 实 非常 棒 ， 意 味 着 只 需要 不 多 的 图 片 、 少 量 的 工 
作 、 低 带宽 和 更 少 的 加 载 时 间 。 

Q border-width: 让 浏览 器 把 元 素 的 边框 定位 在 距 上 0px、 距 右 8px、 距 下 Opx, PE 
左 8px 的 地 方 (4 个 参数 从 上 开始 ， 以 顺 时 针 为 序 )。 不 需要 指定 边框 的 颜色 和 样 
式 。 边 框 宽度 定义 好 之 后 ， 就 要 确定 放 进 去 的 图 片 了 。 

Q  url(images/button.png) 0 8 0 8: 5 个 参数 从 左 到 右 分 别 是 : 图 片 的 URL、 上 边 距 、 


右边 距 、 下 边 距 、 左 边 距 (再 一 次 ， 从 上 顺 时 针 开 始 )。URL 可 以 是 绝对 (比如 
http:/example.com/myBorderlmage.png) 或 者 相对 路 径 ， 后 者 是 相对 于 样式 表 所 在 
的 位 置 的 ， 而 不 是 引用 样式 表 的 HTML 页 面 的 位 置 。 


(3) 在 HTML 文件 中 插入 引入 JavaScript 的 代码 ， 将 对 aaajs 和 bbb.js 的 引用 写 到 


HTML 文件 中 。 


<script type="text/javascript" src="aaa.js"></script> 
<script type="text/javascript" src="bbb.js"></script> 


在 文件 bbbjs 中 ， 我 们 编写 一 段 JavaScript 代码 ， 这 段 代 码 的 主要 作用 是 让 用 户 显示 
或 者 隐藏 nav 菜单 。 代 码 如 下 : 


if (window.innerWidth && window.innerWidth <= 480) ( 


$ (document) . ready (function () { 
$('£header ul').addClass('hide'); 
$('£header').append('«div class-"leftButton" 


onclick-"toggleMenu|()"»Menuc/div»'); 
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5; 
function toggleMenu() { 
$('#header ul').toggleClass('hide'); 
$('£header .leftButton').toggleClass('pressed'); 


J: 

对 上 述 代码 的 具体 说 明 如 下 。 

第 1 行 : 括号 中 的 代码 ， 表 示 当 Window 对 象 的 innerWidth 属性 存在 并 且 innerWidth 
小 于 等 于 480px( 这 是 大 部 分 手机 合理 的 最 大 宽度 值 ) 时 才 执 行 到 内 部 。 该 行 保证 只 有 当 用 户 
使 用 Android 手机 或 者 类 似 大 小 的 设备 访问 这 个 页 面 时 ， 上 述 代 码 才 会 执行 。 

第 2 行 : 使 用 了 函数 document ready， 此 函数 是 “网 页 加 载 完 成 ”函数 。 这 段 代 码 的 
功能 是 设置 当 网 页 加 载 完 成 之 后 才 运行 里 面 的 代码 。 

第 3 行 : 使 用 了 典型 的 jQuery 代码 ， 目 的 是 选择 header 中 的 <ul> 元 素 并 且 往 其 中 添加 
hide 类 开始 。 此 处 的 hide 是 前 面 CSS 文件 中 的 选择 器 ， 这 行 代码 执行 的 效果 是 隐藏 header 
的 岂 元 素 。 

第 4 行 : 此 处 是 给 header 添加 按钮 的 地 方 ， 目 的 是 让 我 们 可 以 显示 和 隐藏 菜单 。 

第 8 fT: 函数 toggleMenu0 用 jQuery 的 toggleClass(0) 函 数 来 添加 或 删除 所 选择 对 象 中 
的 某 个 类 。 这 里 应 用 了 header If] ul 里 的 hide 类 。 

第 9 行 : 在 header 的 leftButton 里 添加 或 删除 pressed 类 ， 类 pressed 的 具体 代码 
如 下 : 


#header div.pressed { 
-webkit-border-image: url(images/button clicked.png) 0 8 0 8; 


) 
通过 上 述 样式 和 JavaScript 行为 设置 以 后 ，Menu 开始 动 起 来 了 ， 默 认 是 隐藏 了 链接 内 
容 ， 单 击 之 后 才 会 在 下 方 显示 链接 信息 ， 如 图 5-13 所 示 。 


关于 我 们 


博客 
联系 我 们 


Android 之 家 

在 线 客服 

在 线 视频 
Menu 


About 


欢迎 大 家 学 习 Android , 88538 —7- o I9 
的 职业 ， 我 也 是 这 么 认为 的 ， 希 望 事实 如 此 -… 


5-13 下 方 显示 信息 
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5.4 在 Android 网 页 中 使 用 Ajax 特效 


Ajax 是 指 异步 JavaScript 和 XML 技术 的 称呼 ， 是 Asynchronous JavaScript And XML 


的 缩写 。 
Web 应 


Ajax 不 是 一 种 新 的 编程 语言 ， 而 是 一 种 用 于 创建 更 好 更 快 以 及 交互 性 更 强 的 
用 程序 的 技术 。 通 过 使 用 Ajax， 我 们 可 使 用 JavaScript 的 XMLHttpRequest 对 象 来 


直接 与 用 


及 务 器 进行 通信 。 通 过 这 个 对 象 ， 我 们 可 在 不 重 载 页 面 的 情况 下 与 Web 服务 器 交换 


Ajax 在 浏览 器 与 Web 服务 器 之 间 使 用 异步 数据 传输 (HTTP 请 求 )， 这 样 就 可 使 网 页 从 
服务 器 请 求 少量 的 信息 ， 而 不 是 整个 页 面 。 
既然 Ajax 和 JavaScript 的 关系 如 此 密切 ， 那 么 就 很 有 必要 在 开发 的 Android 网 页 中 使 


用 Ajax, 


这 样 可 以 给 用 户 带 来 更 精彩 的 体验 。 


本 节 将 从 一 个 具体 例子 开始 ， 讲 解 Ajax 在 Android 网 页 中 的 简单 应 用 。 


实例 5-2 在 Android 系统 中 开发 一 个 Ajax 网 页 下 载 路 径 :\daima\5\gaoiji\ 


(1) 编写 一 个 名 为 android.html 的 HTML 文件 ， 具 体 代码 如 下 : 
<html> 
<head> 


<title>Jonathan Stark</title> 
«meta name-"viewport" content-"user-scalable-no, width-device- 
width" /» 
«link rel-"stylesheet" href-"android.css" type-"text/css" 
media-"screen" /> 
<script type-"text/javascript" src="jquery.js"></script> 
<script type="text/javascript" src="android.js"></script> 
</head> 
<body> 
<div id="header"><h1>AAA</h1></div> 
<div id="container"></div> 
</body> 


</html> 


(2) 


编写 样式 文件 android.css， 主 要 代码 如 下 : 


body { 


} 


background-color: #ddd; 
color: #222; 
font-family: Helvetica; 
font-size: 14px; 
margin: 0; 

padding: 0; 


#header { 


background-color: #ccc; 
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background-image: -webkit-gradient(linear, left top, left bottom, 
from(#ccc), to(#999)); 

border-color: #666; 

border-style: solid; 

border-width: 0 0 1px 0; 


} 

#header hl { 
color: #222; 
font-size: 20px; 
font-weight: bold; 
margin: 0 auto; 
padding: 10px 0; 
text-align: center; 
text-shadow: Opx lpx lpx #fff; 
max-width: 160px; 
overflow: hidden; 
white-space: nowrap; 
text-overflow: ellipsis; 


uber 
list-style: none; 
margin: 10px; 
padding: 0; 
) 
WE dir cy 
background-color: #FFF; 
border: lpx solid #999; 
color: #222; 
display: block; 
font-size: 17px; 
font-weight: bold; 
margin-bottom: -lpx; 
padding: 12px 10px; 
text-decoration: none; 
} 
ul li:first-child a { 
-webkit-border-top-left-radius: 8px; 
-webkit-border-top-right-radius: 8px; 
) 
ul li:last-child a ( 
-webkit-border-bottom-left-radius: 8px; 
-webkit-border-bottom-right-radius: 8px; 
} 
ul li a:active, ul li a:hover { 
background-color: blue; 
color: white; 
} 
#content { 
padding: 10px; 
text-shadow: Opx lpx lpx #fff; 
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#content a { 


} 


color: blue; 


上 述 样 式 文件 在 本 章 的 前 面 内 容 中 都 进行 过 详细 讲解 ， 相 信 读 者 一 读 便 懂 。 
(3) 继续 编写 如 下 HTML 文件 。 


口 
口 
口 
口 
口 


about.html 

blog.html 
contact.html 
consulting-clinic.html 
index.html 


为 了 简单 ， 它 们 的 代码 都 是 一 样 的 ， 具 体 代码 如 下 : 


«html» 


<head> 
<title>AAA</title> 
«meta name-"viewport" content-"user-scalable-no, width-device- 
width" /» 
<link rel="stylesheet" type="text/css" href-"android.css" 
media="only screen and (max-width: 480px)" /> 
<link rel="stylesheet" type="text/css" href="desktop.css" 
media-"screen and (min-width: 481px)" /> 
<!--[if IE]> 
<link rel="stylesheet" type="text/css" href="explorer.css" 
media-"all" /> 
<! [endif]--> 
<script type="text/javascript" src="jquery.js"></script> 
<script type="text/javascript" src="android.js"></script> 
«meta http-equiv-"Content-Type" content-"text/html; charset=gb2312"> 
</head> 
<body> 
<div id="container"> 
<div id="header"> 
<hl><a href="./">AAAA</a></h1> 
<div id="utility"> 
<ul> 
<li><a href-"about.html"»AAA«/a»«/li» 
<li><a href="blog.htm1">BBB</a></1i> 
<li><a href-"contact.html"»CCC«/a»«/li» 
</ul> 
</div> 
<div id="nav"> 
<ul> 
<li><a href-"bbb.html"»DDD«/a»«/li» 
<li><a href="ccc.html">EEE</a></1i> 
<li><a href="ddd.html">FFF</a></1i> 
<li><a href="http://www.aaa.com">GGG</a></1i> 
</ul> 
</div> 
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«/div» 
<div id="content"> 
<h2>About</h2> 
<p> 欢 迎 大 家 学 习 Android， 都 说 这 是 一 个 前 途 辉 煌 的 职业 ， 我 也 是 这 么 认为 
的 ， 希 望 事实 如 此 . . . .</p> 


</div> 
«div id="sidebar"> 
«img alt=" 好 图 片 " src="aaa.png"> 
<p> 欢 迎 大 家 学 习 android， 都 说 这 是 一 个 前 途 辉 煌 的 职业 ， 我 也 是 这 么 认为 
的 ， 希 望 事 实 如 此 - - - .</p> 


</div> 
«div id="footer"> 
«ul» 
<li><a href="bbb.htm1">Services</a></1i> 
<li><a href-"ccc.html"»About«/a»«/li» 
<li><a href="ddd.html">Blog</a></1i> 
</ul> 
<p class="subtle"> isl rule /p» 
</div> 
</div> 
</body> 


</html> 


(4) 编写 JavaScript 文件 androidjs， 在 此 文件 中 使 用 了 Ajax 技术 ， 具 体 代码 如 下 : 

var hist = []; 

var startUrl = 'index.html'; 

$ (document) . ready (function () { 
loadPage (startUrl); 

); 

function loadPage(url) ( 


$('body').append('«div id-"progress"»wait for a moment...«/div»'); 
scrollTo (0,0); 


if (url == startUrl) ( 
var element = ' #header ul'; 
} else { 


var element = ' #content'; 
} 
$('#container').load(url + element, function(){ 
var title = $('h2').html() 11' 你 好 !'; 
$('h1').html (title); 
$('h2').remove(); 
$('.leftButton').remove(); 
hist.unshift(('url':url, 'title':title]); 
if (hist.length » 1) ( 
$('£header').append('«div class= 
"leftButton">'+hist[1].title+'</div>'); 
$('#header.leftButton') .click (function (e) { 
$(e.target) .addClass ('clicked'); 
var thisPage = hist.shift(); 
var previousPage - hist.shift(); 


0B 第 5 章 79 Android 开发 网 页 


loadPage (previousPage.url); 
H3 
} 
$('#container a').click (function(e) { 
var url = e.target.href; 
if (url.match(/aaa.com/)) { 
e.preventDefault (); 
loadPage (url); 
È 
H: 
$('#progress') .remove (); 
he 
$ 


对 于 上 述 代码 的 具体 说 明 如 下 。 
Q 第 1~5 行 : 使 用 了 iQuery 的 document ready 函数 ， 目 的 是 使 浏览 器 在 加 载 页 面 
完成 后 运行 loadPageQ ER 2X. 
口 “ 剩 余 的 行 数 是 函数 loadPage(url) 部 分 ， 此 函数 的 功能 是 载 入 地 址 为 URL 的 网 页 ， 
但 是 在 载 入 时 使 用 了 Ajax 技术 特效 。 具 体 说 明 如 下 。 
e 第 7 行 : 为 了 使 Ajax 效果 能 够 显示 出 来 ，loadPageO 函 数 启动 时 ， 在 body 中 
增加 一 个 正在 加 载 的 div， 然 后 在 hijackLinksO 函 数 结束 的 时 候 删 除 。 
e 第 9~13 行 : 如 果 没 有 在 调用 函数 的 时 候 指定 URL( 比 如 第 一 次 在 document 
ready 函数 中 调用 )，URL 将 会 是 undefined， 这 一 行 会 被 执行 。 这 一 行 和 下 一 
行 是 iQuery 的 load0 函 数 样 例 。load0 函 数 在 为 页 面 增加 简单 快速 的 Ajax 实 
用 性 上 非常 出 色 。 如 果 把 这 一 行 翻译 出 来 ， 它 的 意思 是 “从 index.html 中 找 
出 所 有 加 eader 中 的 ul 元素， 并 把 它们 插入 到 当前 页 面 的 #container 元 素 中 ， 
完成 之 后 再 调用 hijackLinksO 函 数 ”。 当 URL 参数 有 值 的 时 候 ， 执 行 第 12 
行 。 从 效果 上 看 ，“ 从 传 给 loadPage() 函 数 的 URL. 中 得 到 #content 元 素 ， 并 
把 它们 插入 到 当前 页 面 的 #container 元 素 ， 完 成 之 后 调用 hijackLinks() 函 数 。 
(5) 最 后 的 修饰 。 
为 了 能 使 我 们 设计 的 页 面体 现 出 Ajax 效果 ， 还 需 继续 设置 样式 文件 android.css。 
中 为 了 能 够 显示 出 “加 载 中 ...” 的 样式 ， 需 要 在 android.css 中 添加 如 下 对 应 的 修饰 
代码 : 


#progress { 
-webkit-border-radius: 10px; 
background-color: rgba(0,0,0,.7); 
color: white; 
font-size: 18px; 
font-weight: bold; 
height: 80px; 
left: 60px; 
line-height: 80px; 
margin: 0 auto; 


position: absolute; 
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text-align: center; 
top: 120px; 
width: 200px; 

} 


© 用 边框 图 片 修饰 返回 按钮 ， 并 清除 默认 点 击 后 高 亮 显示 的 效果 。 在 文件 android.css 
中 添加 如 下 修饰 代码 : 


#header div.leftButton { 
font-weight: bold; 
text-align: center; 
line-height: 28px; 
color: white; 
text-shadow: Opx -lpx lpx rgba(0,0,0,0.6); 
position: absolute; 
top: 7px; 
left: 6px; 
max-width: 50px; 
white-space: nowrap; 
overflow: hidden; 
text-overflow: ellipsis; 
border-width: 0 8px 0 14px; 
-webkit-border-image: url(images/back button.png) 0 8 0 14; 
-webkit-tap-highlight-color: rgba(0,0,0,0); 
) 


此 时 在 Android 中 执行 上 述 文件 ， 执 行 后 先 加 载 页 面 ， 在 加 载 时 会 显示 “wait for a 
moment...” 的 提示 ， 如 图 5-14 所 示 。 在 滑动 选择 某 个 链接 的 时 候 ， 被 选中 的 会 有 不 同 的 颜 
色 ， 如 图 5-15 所 示 。 


AAAA 
FT AAA 
loss BBB 
| DDD | DDD ] 
EEE EEE 
FFF FFF 
GGG GGG 
图 5-14 ”提示 特效 图 5-15 被 选择 的 不 同 颜色 


而 文件 android.html 的 执行 效果 和 其 他 文件 相 比 稍 有 不 同 ， 如 图 5-16 所 示 。 这 是 因为 
在 编码 时 有 意 而 为 之 的 。 
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图 5-16 文件 android.html 的 执行 效果 
5.5 让 Android 网 页 充满 灵动 活力 


除了 可 以 为 Android 网 页 实现 Ajax 特效 之 外 ， 还 可 以 为 其 添加 动画 效果 ， 这 样 会 让 我 
们 的 Android 网 页 更 加 充满 活力 。 


5.5.1 开源 框架 一 一 JQTouch 


JQTouch 为 我 们 提供 了 一 系列 功能 的 jQuery 插件 ， 这 些 功能 可 以 为 手机 浏览 器 
WebKit 服务 。 目 前 ， 随 着 Android 手机 、iPhone、iTouch、iPad 等 产品 的 流行 ， 越 来 越 多 
的 开发 者 想 开 发 相关 的 应 用 程序 。 到 目前 ， 苹 果 只 提供 了 Objective-C 语言 去 编写 iPhone 
应 用 程序 。 但 可 惜 的 是 ， 即 使 苹果 的 总 裁 乔 布 斯 吹 咕 它 的 易 用 性 ，C 语言 本 身 是 不 容易 学 
习 的 语言 ， 跟 开发 Web 网 站 来 比 却 更 加 复杂 。 不 过 这 一 切 将 发 生变 化 ， 因 为 jQuery 的 工 
具 JQTouch 出 现 了 。 

使 用 JQTouch 的 目的 是 使 构建 基于 Android 和 iPhone 的 应 用 变 得 更 加 容易 ， 而 所 有 的 
只 需要 一 点 HIML、CSS 和 一 些 JavaScript 知识 ， 就 能 够 创建 可 在 WebKit 浏览 器 上 
(iPhone、Android、Palm Pre) 运 行 的 手机 应 用 程序 。 

读者 可 以 在 其 官方 网 址 http://www.jqtouch.com/ 下 载 资源 。 因 为 是 开源 的 ， 所 以 下 载 后 
可 以 直接 使 用 。 


5.5.2 ”JQTouch 简 单 应 用 


接 下 来 将 以 一 个 具体 的 实例 ， 来 详细 讲解 使 用 JQTouch 框架 为 Android 实现 动画 效果 
的 过 程 。 


3c fil 目 的 源码 路 径 


在 Android 系统 中 使 用 JQTouch 框架 开发 网 页 | 下载 路 径 \daima\5\donghua\ 
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首先 编写 一 个 名 为 index.html 的 HTML 文件， 具体 代码 如 下 : 


<!DOCTYPE html» 
<html> 
<head> 
<title>AAA</title> 
<link type="text/css" rel="stylesheet" media="screen" 
href="jqtouch/jqtouch.css"> 
<link type="text/css" rel="stylesheet" media="screen" 
href="themes/jqt/theme.css"> 
<script type="text/javascript" src="jqtouch/jquery.js"></script> 
<script type-"text/javascript" src="jqtouch/jqtouch.js"></script> 
<script type="text/javascript"> 
var jQT = $.jQTouch ({ 
icon: 'kilo.png' 
H: 
</script> 
</head> 
<body> 
<div id="home"> 
<div class="toolbar"> 
<h1>Data</h1> 
<a class="button flip" href="#settings">Settings</a> 
</div> 
<ul class="edgetoedge"> 
<li class="arrow"><a hre 
<li class="arrow"><a href 
</ul> 
</div> 
<div id="about"> 
<div class="toolbar"> 


"#dates">Dates</a></li> 
"#about">About</a></1i> 


Xhl»About«/hl» 

<a class="button back" href="#">Back</a> 
</div> 
<div> 

<p>Choose you food.</p> 
</div> 


</div> 
<div id="dates"> 
<div class="toolbar"> 


<hl>Time</h1> 
<a class="button back" href="#">Back</a> 
</div> 


<ul class="edgetoedge"> 
<li class="arrow"><a id="0" href="#date">AAA</a></1i> 
<li class="arrow"><a id="1" href="#date">BBB</a></1i> 
<li class="arrow"><a id="2" href="#date">CCC</a></1i> 
<li class="arrow"><a id="3" href="#date">DDD</a></1i> 
<li class="arrow"><a href="#date">EEE</a></1i> 
<li class="arrow"><a id="5" href="#date">FFF</a></1i> 

</ul> 

</div> 
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«div id="date"> 
«div class="toolbar"> 
<hl>Time</h1> 
<a class="button back" href="#">Back</a> 
<a class="button slideup" href="#createEntry">+</a> 
</div> 
<ul class="edgetoedge"> 
<li id-"entryTemplate" class-"entry" style="display:none"> 
<span class="label">Label</span> <span class= 
"calories">000</span> <span class="delete">Delete</span> 
</li> 
</ul> 
</div> 
<div id="createEntry"> 
<div class="toolbar"> 


<h1>WHY</h1> 
<a class="button cancel" href="#">Cancel</a> 
</div> 


<form method="post"> 
<ul class="rounded"> 
«li»«input type="text" placeholder-"Food" name="food" id= 
"food" autocapitalize-"off" autocorrect-"off" 
autocomplete-"off" /»«/li» 
<li><input type="text" placeholder-"Calories" name= 
"calories" id-"calories" autocapitalize-"off" 
autocorrect-"off" autocomplete-"off" /»«/li» 
«li»«input type-"submit" class-"submit" name-"waction" 
value-"Save Entry" /»«/li» 
«/ul» 
«/form» 
«/div» 
«div id="settings"> 
<div class="toolbar"> 


<hl>Control</h1> 
<a class="button cancel" href="#">Cancel</a> 
</div> 


<form method="post"> 
<ul class="rounded"> 
«li»«input placeholder="Age" type="text" name="age" 
id="age" /»«/li» 
<li><input placeholder="Weight" type="text" name= 
"weight" id-"weight" /»«/li» 
<li><input placeholder-"Budget" type="text" name= 
"budget" id-"budget" /»«/li» 
«li»«input type-"submit" class-"submit" name-"waction" 
value-"Save Changes" /»«/li» 
«/ul» 
«/form» 
«/div» 
</body> 
</html> 
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接 下 来 开始 对 上 述 代码 进行 详细 讲解 。 
(1) 通过 如 下 代码 启用 JQTouch 和 jQuery: 


<script type="text/javascript" src: 


jqtouch/jquery.js"></script> 


<script type="text/javascript" src="jqtouch/jqtouch.js"></script> 


(2) 实现 home 面板 ， 具 体 代码 如 下 : 


<div id="home"> 
<div class="toolbar"> 


<hl>Data</h1> 
<a class="button flip" href="#settings">Settings</a> 
</div> 
<ul class="edgetoedge"> 
<li class="arrow"><a href="#dates">Dates</a></1li> 
<li class="arrow"><a href="#about">About</a></1li> 
</ul> 
</div> 


对 应 的 效果 如 图 5-17 所 示 。 


图 5-17 home 面板 


(3) 实现 about 面板 ， 具 体 代码 如 下 。 


<div id="about"> 
<div class="toolbar"> 


«hl»About«/hl» 

<a class="button back" href="#">Back</a> 
</div> 
<div> 

<p>Choose you food.</p> 
</div> 


</div> 


对 应 的 效果 如 图 5-18 所 示 。 


图 5-18 about 面板 


(4) 实现 dates 面板 ， 具 体 代 码 如 下 : 


<div id="dates"> 
<div class="toolbar"> 
<hl>Time</h1> 
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<a class="button back" href="#">Back</a> 

</div> 

<ul class="edgetoedge"> 
<li class="arrow"><a id="0" href="#date">AAA</a></1i> 
EP "arrow"»«a id="1" href="#date">BBB</a></1li> 
EL href="#date">CCC</a></1li> 
UT href="#date">DDD</a></1i> 
cn href="#date">EEE</a></1li> 
<li class-"arrow"»«a id-"5" href="#date">FFF</a></li> 

</ul> 

</div> 


对 应 的 效果 如 图 5-19 所 示 。 


"arrow"><a 
"arrow"><a 


"arrow"><a 


图 5-19 dates 面 板 


(5) 实现 date 面板 ， 具 体 代 码 如 下 : 


<div id="date"> 
<div class="toolbar"> 
<hl>Time</h1> 
<a class="button back" href="#">Back</a> 
<a class="button slideup" href="#createEntry">+</a> 
</div> 
<ul class="edgetoedge"> 
<li id-"entryTemplate" class-"entry" style="display:none"> 
<span class="label">Label</span> <span class= 
"calories">000</span> «span class="delete">Delete</span> 
</li> 
</ul> 
</div> 


(6) 实现 settings 面板 ， 具 体 代 码 如 下 : 


«div id="settings"> 
<div class="toolbar"> 


<hl>Control</hl1> 
<a class="button cancel" href="#">Cancel</a> 
</div> 


<form method="post"> 
<ul class="rounded"> 
<li><input placeholder="Age" type="text" name="age" 
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id-"age" /»«/li» 

«li»«input placeholder-"Weight" type="text" name= 
"weight" id-"weight" /»«/li» 

«li»«input placeholder-"Budget" type="text" name= 
"budget" id-"budget" /»«/li» 

<li><input type="submit" class-"submit" name-"waction" 
value-"Save Changes" /»«/li» 

«/ul» 
«/form» 
«/div» 


对 应 的 效果 如 图 5-20 所 示 。 


Cancel Control 


图 5-20 settings 面 板 


Me dts 


接 下 来 看 样式 文件 theme.css。 此 样式 文件 非常 简单 ， 功 能 是 对 index.html 中 的 元 素 进 
行 修 饰 。 其 实 图 $-17 一 图 5-20 都 是 经 过 theme.css 修饰 之 后 的 显示 效果 。 主 要 代码 如 下 : 


body ( 
background: $000; 
color: #ddd; 

) 

qe » * 1 
background: -webkit-gradient(linear, 0% 0%, 0% 100%, from(#333), 

to(45e5e65)); 

} 

Hac hl, #jqt h2 ( 
font: bold 18px "Helvetica Neue", Helvetica; 
text-shadow: rgba(255,255,255,.2) 0 1px 1px; 
color: #000; 
margin: 10px 20px 5px; 

b 

/* (group Toolbar */ 

#jqt .toolbar ( 
-webkit-box-sizing: border-box; 
border-bottom: lpx solid #000; 
padding: 10px; 
height: 45px; 
background: url(img/toolbar.png) #000000 repeat-x; 
position: relative; 

} 

#jqt .black-translucent .toolbar { 
margin-top: 20px; 
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#jqt -toolbar > hl ( 
position: absolute; 
overflow: hidden; 
left: 50$; 
top: 10px; 
line-height: lem; 
margin: lpx 0 0 -75px; 
height: 40px; 
font-size: 20px; 
width: 150px; 
font-weight: bold; 
text-shadow: rgba(0,0,0,1) 0 -1px 1px; 
text-align: center; 
text-overflow: ellipsis; 
white-space: nowrap; 
color: #fff; 

) 

#jqt.landscape .toolbar > hl ( 
margin-left: -125px; 
width: 250px; 

) 

#jqt .button, #jqt .back, #jqt .cancel, #jqt .add { 
position: absolute; 
overflow: hidden; 
top: 8px; 
right: 10px; 
margin: 0; 
border-width: 0 5px; 
padding: 0 3px; 
width: auto; 
height: 30px; 
line-height: 30px; 
font-family: inherit; 
font-size: 12px; 
font-weight: bold; 
color: #fff; 
text-shadow: rgba(0, 0, 0, 0.5) Opx -lpx 0; 
text-overflow: ellipsis; 
text-decoration: none; 
white-space: nowrap; 
background: none; 

-webkit-border-image: url(img/button.png) 0 5 0 5; 

} 

#jqt .button.active, #jqt .cancel.active, #jqt .add.active { 
-webkit-border-image: url(img/button clicked.png) 0 5 0 5; 
color: #aaa; 

$ 

#jqt .blueButton { 

-webkit-border-image: url(img/blueButton.png) 0 5 0 5; 
border-width: 0 5px; 
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#jqt -back ( 
left: 6px; 
right: auto; 
padding: 0; 
max-width: 55px; 
border-width: 0 8px 0 14px; 
-webkit-border-image: url(img/back button.png) 0 8 0 14; 


) 

#jqt .back.active { 
-webkit-border-image: url(img/back button clicked.png) 0 8 0 14; 

) 

#jqt .leftButton, £jqt .cancel { 
left: 6px; 
right: auto; 

) 

jat .add ( 
font-size: 24px; 
line-height: 24px; 
font-weight: bold; 

} 

#jqt .whiteButton, 

#jqt .grayButton, #jqt .redButton, #jqt .blueButton, #jqt .greenButton { 
display: block; 
border-width: 0 12px; 
padding: 10px; 
text-align: center; 
font-size: 20px; 
font-weight: bold; 
text-decoration: inherit; 
color: inherit; 


#jqt .whiteButton.active, #jqt .grayButton.active, 
#jqt .redButton.active, #jqt .blueButton.active, 
#jqt .greenButton.active, 
#jqt .whiteButton:active, #jqt .grayButton:active, 
#jqt .redButton:active, #jqt .blueButton:active, 
#jqt .greenButton:active { 
-webkit-border-image: url(img/activeButton.png) 0 12 0 12; 
) 
#jqt .whiteButton { 
-webkit-border-image: url(img/whiteButton.png) 0 12 0 12; 
text-shadow: rgba(255, 255, 255, 0.7) 0 1px 0; 
} 
#jqt .grayButton { 
-webkit-border-image: url(img/grayButton.png) 0 12 0 12; 
color: £FFFFFF; 
} 


上 述 代码 只 是 theme.css 的 15， 具体 内容 请 读者 参考 本 书 下 载 资源 中 的 源码 。 因 为 里 
面 的 内 容 都 在 本 书 前 面 的 知识 中 讲解 过 ， 所 以 在 此 不 再 占用 篇 幅 。 
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到 此 为 止 ， 我 们 的 页 面 就 能 够 动 起 来 了 ， 每 一 个 页 面 的 切换 都 具有 了 动画 效果 ， 如 
图 5-21 所 示 。 


Data 
AMAA” 


P Na & 
tay 


laali Jax dua da, laxoko ioiii in | 


mams 


图 5-21 闪烁 的 动画 效果 
书 的 截图 体现 不 出 动画 效果 ， 建 议 读者 在 模拟 器 上 亲自 实践 体验 。 
和 注意 ; 其 实 最 后 的 步骤 就 是 使 用 JQTouch 了 ， 因 为 是 开源 部 分 ， 所 以 无 须 笔者 耗费 

篇 幅 ， 笔 者 做 的 工作 只 是 设置 了 里 面 的 几 个 属性 而 已 。 文件 jqtouchjs 比较 
长 ， 读 者 想 理解 JOTouch 开源 代码 的 各 个 部 分 ， 可 以 参阅 相关 资料 。 如 果 个 
人 JavaScript、Ajax、CSS、HTML 水 平 很 不 错 ， 建 议 下 载 开 源 代码 自己 分 
析 。 网 上 也 有 很 多 参考 资料 ， 现 在 比较 著名 的 是 LUPA 社区 中 的 在 线 分 析 教 
程 。URL 地 址 如 下 : 
http://code.lupaworld.com/code.php?mod=list&itemid=39&path=./kissy_1.1.7/ 
此 教程 界面 清新 ， 左 侧 是 导航 ， 十 分 便于 我 们 的 浏览 ， 如 图 5-22 所 示 。 

8$ 返回 上 一 目录 路 径 : ./kissy_1.1.7 

E ajax 


(aa base 2011-02-23 

E button ME EEE: jatouch_1.0 Bh: FEARI Touch EMI 
di Ajax t 

Ea calendar 

E component 

E cookie 


mom ASEMENEA, SUHADHBAS. 
E csscommon 进入 技 相 群 组 查看 更 多 项 目 广 码 分 析 广 间 
(ai cssgrids 

E cssreset 

x datalazyload 

Es dd 

Es dom 

E event 

E flash 

E imagezoom 


图 5-22 JQTouch 在 线 源码 分 析 
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5.6 为 网 页 增加 数据 存储 功能 


大 多 数 软件 程序 都 需要 某 种 持久 化 的 方式 来 存储 有 用 的 数据 。 对 于 网 络 应 用 程序 ， 这 
个 任务 一 般 会 交 给 服务 器 端的 数据 库 或 者 在 浏览 器 的 cookie 中 来 完成 。 伴 随 着 HTML 5 的 
EI, Web 开发 者 有 了 另外 两 种 选择 : Web Storage 和 Web SQL Database. 


5.6.1 在 Android 网 页 中 使 用 Web Storage 


Web Storage 有 两 种 形式 ， 分 别 是 localStorage( 本 地 存储 ) 和 sessionStorage( 会 话 存储 )。 
这 两 种 形式 都 允许 开发 者 使 用 JavaScript 设置 键 值 对 ， 并 在 重新 加 载 不 同 页 面 的 时 候 读 出 
它们 ， 这 一 点 和 现在 cookie 机 制 非常 类 似 。 但 是 和 cookie 不 同 的 是 ，Web Storage 的 数据 
是 完全 存储 在 客户 端的 ， 无 须 通过 浏览 器 的 请 求 再 传输 到 服务 器 。 由 此 可 见 ， 和 cookie 方 
式 相 比 ，Web Storage 可 以 在 本 地 存储 更 多 的 数据 。 
localStorage 和 sessionStorage 在 功能 上 是 一 样 的 ， 只 是 在 持久 性 和 范围 上 有 所 不 同 。 
Q localStorage: 即使 已 经 关闭 了 浏览 窗口 ， 数 据 也 会 被 保存 起 来 并 可 用 于 所 有 来 自 
同 源 (必须 有 相同 的 域名 、 协 议和 端口 ) 窗 口 (或 者 标签 页 ) 的 加 载 ， 这 对 参数 设置 或 
是 偏好 设置 之 类 的 功能 非常 有 用 。 
Q sessionStorage: 数据 存储 在 窗口 对 象 中 ， 对 于 其 他 窗口 或 者 标签 页 不 可 见 ， 并 且 
当 窗 口 关闭 时 会 丢失 数据 。sessionStorage 可 用 于 特殊 的 窗口 状态 ， 例 如 一 个 标签 
页 的 高 亮 状态 或 者 一 个 表格 的 排序 状态 。 例 如 在 下 面 的 代码 中 ，sessionStorage 都 
可 以 用 localStorage 来 代替 ， 但 是 在 窗口 或 者 标签 页 关闭 时 ， 会 丢失 使 用 
sessionStorage 存储 的 数据 。 
设置 参数 的 方法 非常 简单 ， 例 如 : 
localStorage.setItem('age'.40); 
访问 一 个 存储 的 数据 的 方法 非常 简单 ， 例 如 : 
var age-localStorage.getItem('age'); 
可 以 这 样 删除 一 个 特定 的 键 值 对 : 


localStorage. removeItem('age'); 


或 者 删除 所 有 的 键 值 对 : 
localStorage.clear(); 
候 设 我 们 的 键 是 有 效 的 _JavaSeript token， 比 如 没有 空格 、 除 下 划 线 之 外 的 标点 ， 则 可 
以 使 用 如 下 语法 : 
localstorage.age=4e // 设 置 age 的 值 


var age-localStorage.age;  // 取 得 age 的 值 
delete localStorage.age: // 从 存储 中 删除 age 
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其 实 localStorage 和 sessionStorage 中 键 的 存储 是 分 开 的 。 如 果 你 在 两 种 存储 中 使 用 同 
样 的 键 名 也 是 没有 冲突 的 。 

1. 将 用 户 设置 保存 到 localStorage 

下 面 介绍 一 个 实际 的 例子 ， 目 的 是 更 新 本 章 前 面 例子 中 的 settings 面板 ， 此 时 可 以 让 
它 把 表单 数据 存储 到 localStorage 当中 。 接 下 来 会 有 相当 数量 的 JavaScript 代码 ， 但 是 并 不 
准备 把 它们 都 放 进 HTML 文件 的 head 标签 中 。 为 了 保持 代码 的 工整 ， 在 存放 HTML 文档 
的 相同 路 径 下 创建 一 个 名 为 123js 的 文件 ， 同 时 更 新 HTML 文件 的 head 部 分 来 引用 
123 js. 


<head> 

<title>123</title> 

<link type="text/css" rel="stylesheet" media-"screen" 
href="jqtouch/jqtouch.css"> 

<link type="text/css" rel="stylesheet" media-"screen" 
href="themes/jqt/theme.css"> 

<script type-"text/javasc ript" src="jqtouch/jquery.js">< /script> 
<script type="text/javasc ript" src="jqtouch/jqtouch.js">< / script» 
<script type="text/javascript" src="123.js"</script> 

</head> 

由 此 可 见 ， 在 更 新 的 同时 也 从 HTML 的 head 部 分 删除 了 jQTouch 的 构造 函数 。 其 实 
它 并 没有 被 删除 ， 只 是 被 移 到 文件 123.js 文件 中 罢了 。 但 需要 确保 从 HTML 的 head 部 分 
中 删除 上 述 提 到 的 内 容 并 且 在 相同 路 径 下 建立 如 下 内 容 的 1233s 文件 ， 然 后 在 浏览 器 中 刷 
新 主 HTML 文件 以 确保 它 仍旧 可 以 工作 : 

var jQT-$.jQTouch(( 
icon:'123.png' 
})s 

代码 经 过 重新 组 织 以 后 ， 可 以 添加 保存 设置 的 代码 了 。 需 要 重 写 settings 表单 的 提交 
动作 的 代码 ， 并 用 一 个 名 为 saveSettingsO 的 自 定义 函数 蔡 换 。 因 为 用 到 了 jQTouch， 所 以 
只 需 修改 Document Ready 函数 中 的 一 行 代码 即 可 。 将 下 面 的 代码 加 入 到 123js 文件 中 : 

$ (document) . ready (function () { 
$('#settings form') .submit (saveSettings); 

这 段 代 码 的 作用 是 ， 当 用 户 提交 settings 表单 时 ， 用 saveSettings0 函 数 的 运行 代替 表 
单 的 提交 动作 。 当 调用 saveSettings() PARLIN, zx Hl jQTouch 的 val0 函 数 获得 表单 的 3 个 输 
入 项 ， 并 且 分 别 存 入 localStorage 这 个 同名 变量 中 。 将 下 面 的 函数 加 入 123.js 文件 中 : 

function saveSettings() { 
localStorage.age-$('£age').val(); 
localStorage.budget-$ ("#budget") .val (); 
localStorage.weight=$ ('#weight').val.(); 


JOQT.goBack(); 
return false; 
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一 旦 数值 被 保存 ， 便 调用 jQTouch 的 goBackO MAMA 2 行 到 最 后 一 行 ) 来 关闭 面板 
并 返回 前 一 个 页 面 。 接 下 来 ， 返 回 false 给 触发 这 个 函数 的 提交 事件 ， 以 防 进 行 默认 的 提交 
操作 。 如 果 没 有 这 行 代码 ， 现 有 页 面 会 被 重新 加 载 一 次 ， 这 显然 不 是 我 们 希望 的 。 

到 此 为 止 已 经 可 以 运行 程序 ， 前 往 settings 面板 输入 设置 ， 然 后 提交 表单 将 设置 存储 
到 localStorage 中 。 由 于 在 提交 表单 时 没有 清空 相关 字段 ， 当 用 户 再 次 访问 settings 面板 
时 ， 上 次 输入 的 数据 仍然 会 存在 。 然 而 这 不 是 因为 使 用 了 localStorage 保存 的 缘故 ， 而 是 
因为 只 要 输入 过 后 不 清理 ， 这 些 字段 会 一 直 在 那里 。 因 此 ， 当 用 户 下 次 重新 运行 程序 并 访 
|j] settings 面板 时 ， 即 使 这 些 字段 被 保存 了 ， 它 们 仍 会 丢失 。 

为 了 解决 这 个 问题 ， 需 要 使 用 函数 loadSettings0) 来 加 载 配置 ， 所 以 在 123.js 文件 中 添 
加 以 下 函数 : 

function loadSettings() { 
$('fage').val(localStorage.age); 
$('#budget') .val (localStorage.budget) ; 
$('#weight') .val (localStorage.weight) ; 
) 

函数 loadSettings0 和 函数 saveSettings0 是 相反 的 ， 它 使 用 localStorage 中 的 相应 字段 来 
调用 jQTouch 的 函数 val0 来 设置 settings 表单 中 的 3 个 字段 值 。 

接 下 来 需要 用 方法 来 触发 已 有 的 loadSettings0 函 数 ， 触 发 时 刻 是 当 程序 启动 时 。 为 了 
实现 这 个 功能 ， 在 123.js 的 document ready 函数 中 添加 如 下 代码 : 

$ (document) . ready (function () { 
$('#settings form').submit (saveSettings); 
loadSettings (); 

) 

但 是 遗憾 的 是 ， 在 程序 启动 加 载 配 置 时 有 一 个 漏洞 ， 如果 当 用 户 访问 settings 面板 ， 
改动 了 一 些 值 ， 然 后 点 击 Cancel 按钮 而 非 提交 表单 ， 下 次 程序 就 不 能 加 载 正 确 的 配置 。 在 
这 种 情况 下 ， 当 用 户 再 次 访问 settings 面板 时 ， 会 显示 最 新 的 修改 。 这 不 是 因为 这 些 新 的 
数据 被 保存 了 (实际 上 并 没有 )， 而 只 是 界面 显示 的 问题 。 如 果 用 户 关闭 并 重新 启动 程序 ， 
显示 的 数据 又 会 变 成 之 前 保存 的 数据 ， 因 为 loadSettings0 函 数 会 在 程序 启动 的 时 候 还 原 字 
段 中 的 数据 。 

其 实 有 很 多 方法 可 以 改变 这 种 情况 ， 但 最 合适 的 方法 应 该 是 : 每 次 当 settings 面板 移 
动 时 ， 无 论 进入 还 是 退出 ， 都 需要 刷新 显示 的 数据 。 在 jQTouch 中 提供 了 一 种 简单 的 方法 
将 loadSettingsO 函 数 和 settings 面板 的 pageAnimationStart 事件 绑 定 起 来 。 将 刚刚 加 入 的 代 
码 用 如 下 加 粗 代码 来 代替 : 

$ (document) . ready (function () { 

$('#settings form') .submit (saveSettings); 

$('#settings') .bind('pageAnimationStart' , loadSettings) ; 

he 

现在 123.js 中 的 JavaScript 代码 为 settings 面板 提供 了 持久 化 的 数据 存储 。 当 再 看 实现 
此 功能 的 代码 时 ， 发 现 其 实 并 不 算 多 。 以 下 是 到 目前 为 止 123js 中 的 代码 : 
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var jQT-$.jQTouch(( 

icon: '123.png' 

2): 

$ (document) . ready (function () { 
$('#settings form') .submit (saveSettings) ; 
$('£settings').bind('pageAnimationStart',loadSettings); 
DE 

function loadSettings() { 
$('#age') .val (localStorage.age) ; 
$('#budget') .val (localStorage.budget) ; 
$('#weight') .val (localStorage.weight) ; 

) 

function saveSettings() { 
localStorage.age=$('#age') .val(); 
localStorage.budget=$ ('#budget') .val(); 
localStorage.weight-$ ('#weight') .val(); 
JOQT.goBack () : 

return false: 

) 


2. 将 选中 的 数据 保存 到 sessionStorage 中 


我 们 最 终 的 目的 是 配置 date 面板 ， 使 得 每 次 显示 时 它 都 会 根据 输入 的 日 期 检索 数据 库 
中 所 有 的 记录 ， 然 后 在 边 对 边 (Edge-To-Edge) 的 列表 中 显示 出 来 。 这 就 要 求 date 面板 知道 
用 户 在 dates 面板 上 点 击 了 哪个 日 期 。 

另外 还 希望 允许 用 户 在 数据 库 中 添加 或 者 删除 条 目 ， 所 以 需要 支持 date 面板 上 已 经 存 
在 的 “+” 按 钮 和 Delete 按钮 。 第 一 步 是 当 用 户 从 dates 面板 访问 date 面板 时 ， 需 要 让 date 
面板 知道 用 户 点 击 的 是 哪个 条 目 。 有 了 这 个 信息 ， 就 可 以 计算 出 合适 的 日 期 的 上 下 文 语 
境 。 为 了 实现 它 ， 需 要 在 123.js 的 document reday 函数 中 添加 如 下 代码 : 

$ (document) . ready (function () { 


$('#settings form') .submit (saveSettings); 
$('#settings') .bind('pageAnimationStart', loadSettings); 


$('#dates li a').click(function()( //(1) 
var dayOffset-this.id; //(2) 
var date-new Date(); //(3) 


date.setDate (date.getDate() - dayOffset); 
sessionStorage.currentDate-date.getHonth()-414'/'4 
date.getDate()+'/'+ 


date.getFullYear(); //(4) 
refreshEntries (); //(5) 
n: 
n: 
(1) JQTouch 中 的 click0 函 数 将 它 随后 的 JavaScript 代码 和 dates 面板 中 click 事件 的 链 
接 绑 定 起 来 。 


(2) 获取 被 点 击 对 象 的 ID， 并 且 将 其 存 入 dayOffset 变量 中 。dates 面板 中 的 链接 都 有 
范围 从 0—5 的 ID， 所 以 被 点 击 的 链接 的 ID 就 相当 于 点 击 日 期 所 需要 计算 的 天 数 ， 比 如 ， 
过 去 0 天 表示 今天 ， 过 去 1 天 表示 昨天 ， 过 去 2 天 表示 前 天 …… 
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(3) 创建 了 一 个 新 的 JavaScript 日 期 对 象 ， 并 且 将 其 存 入 一 个 叫 date 的 变量 中 。 首 
先 ， 这 个 date 会 被 设置 成 创建 的 日 期 ， 所 以 在 下 一 行 中 ， 会 从 getDateO) 函 数 的 结果 中 减 去 
dayOffset， 再 用 setDate0) 函 数 将 日 期 设置 成 选中 的 日 期 。 其 中 dayOffset 为 0 表示 今天 ，1 
表示 昨天 ， 依 此 类 推 。 

(4) 生成 了 一 个 “MM/DD/YYYY ”格式 的 日 期 字符 串 ， 并 将 其 作为 当前 日 期 
(currentDate) 存 入 sessionStorage。 

(5) 调用 refreshEntries0 函 数 。 此 函数 的 作用 是 ， 基 于 用 户 点 击 dates 面板 的 日 期 值 来 
正确 更 新 date 面板 。 现 在 只 要 使 用 用 户 选 中 的 日 期 来 更 新 dates 面板 工具 栏 上 的 标题 ， 就 
能 看 到 它 起 作用 了 。 如 果 没 有 这 个 函数 ， 运 行 后 只 会 出 现 “Date” 字 样 ， 而 不 会 出 现 数 
Hi. PAR refreshEntries0 应 添加 到 文件 123.js F: 

function refreshEntries() { 

var currentDate-sessionStorage.currentDate; 


$('#date hl').text (currentDate); 
) 


5.6.2 ”在 Android 网 页 中 使 用 Web SQL Database 


EMH HTML 5 的 特性 中 ，Web SQL Database 的 功能 非常 强大 。Web SQL Database 
提供 给 开发 者 一 个 简单 而 强大 的 JavaScript 数据 库 API， 使 得 可 以 在 一 个 本 地 SQLite 数据 
库 中 持久 保存 数据 。 其 实 从 技术 上 讲 ，Web SQL Database 并 非 HTML 5 的 一 部 分 ， 它 其 实 
是 摆脱 了 HTML 5 的 细则 ， 并 将 其 融入 自己 的 细则 当中 。 但 一 般 提 到 它 ， 还 是 会 说 是 
HTML 5 的 特性 。 

开发 者 可 以 使 用 标准 SQL 语句 来 创建 数据 表 及 插入 、 更 新 、 查 找 和 删除 行 。 
JavaScript Database API 其 至 能 够 支持 transaction( 事 务 )。SQL 有 与 生 俱 来 的 复杂 性 ， 但 无 
论 如何 ， 这 是 一 个 改变 游戏 规则 的 变化 ， 所 以 关注 它 本 身 可 能 会 更 有 意义 。 

1. 创建 数据 库 

现在 用 户 已 经 选择 好 date 面板 的 所 需 数据 了 ， 我 们 已 经 掌握 所 有 让 用 户 创建 条 目 所 必 
要 的 信息 。 在 编写 createEntry0 函 数 之 前 ， 还 要 建立 一 个 数据 库 来 存储 提交 的 数据 (这 是 一 
个 一 次 性 的 操作 )。 可 以 在 123js 中 添加 如 下 代码 来 实现 这 项 功能 : 

var db; //) 
$ (dacument) . ready (function () { 

$('£settings form') .submit (saveSettings); 
$('#settings') .bind('pageAnimationSta rt', loadSettings) ; 
$('£dates li a').click(functian()( 

var dayOffset-this.id; 

var date-new Date(); 

date.setDate(date.getDate() - dayOffset) ; 
sessionStorage.currentDate=date.getMonth ()+1+'/'+ 
date. getDate()+'/'+ 

date. getFullYear(); 


refreshEntries (); 
he 
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var shortName-'123'; // (2) 
var version='1.0'; 

var displayName-'123'; 

var maxSize-65536; 


db-openDatabase (shortName, version, displayName, maxSize) ; SAEN) 
db.transaction( // (4) 
function (transaction) { // (5) 
transaction.executeSql( // 16) 


'CREATE TABLE IF NOT EXISTS entries '+ 
' (id INTEGER NOT NULL PRIMARY KEY AUTOINCREHENT, '+ 
' date DATE NOT NULL, food TEXT NOT NULL, '+ 
"calories INTEGER NOT NULL); ' 
E 
} 
Dx 
he 
(1) 首先 要 注意 的 是 ， 在 程序 里 有 一 个 名 为 db 的 全 局 变量 。 一 旦 建立 一 个 数据 库 连 
接 ， 这 个 变量 会 保存 连接 的 引用 。 之 所 以 被 设置 成 全 局 变量 ， 是 因为 我 们 将 会 在 程序 的 各 
个 地 方 都 用 到 它 。 
Q) 接 下 来 的 4 行 代码 定义 了 调用 openDatabase 需要 的 参数 。 
Q shortName: 一 个 指向 硬盘 上 的 数据 库 文件 的 字符 串 。 
Q version: 当 需 要 修改 数据 库 模式 时 用 来 管理 升级 和 向 后 兼容 的 数字 。 例 如 ， 每 次 
程序 启动 时 检查 version 字段 ， 如 果 过 期 ， 创 建 一 个 新 的 数据 库 并 且 将 旧 数 据 库 
中 的 数据 移 到 新 数据 库 中 。 

Q displayName: 对 用 户 显 示 的 字符 串 。 例 如 ，displayName 会 显示 在 Chrome 主 界 
面 上 的 Developer Tools 里 的 Storage 标签 中 (View — Developer — Developer 
Tools). 

Q maxSize: 允许 数据 库 增长 到 的 最 大 KB 数 。 

(3) 当 参 数 被 设置 以 后 ， 这 行 代码 将 会 调用 openDatabase 并 且 将 数据 库 连接 存储 到 db 
变量 中 。 如 果 数 据 库 不 存在 ， 将 会 新 建 一 个 。 

(4) 所 有 的 数据 库 查询 都 必须 放 在 一 个 事务 的 上 下 文 当中 ， 所 以 这 里 调用 了 一 个 db 对 
象 的 transaction 方法 。 而 接 下 来 的 几 行 代码 会 构造 一 个 函数 作为 唯一 的 参数 传 入 transaction 
Jk. 

(5) 从 本 行 开始 是 一 个 匿名 函数 ， 将 transaction 对 象 当 作 人 参数 传 入 。 

(6) 一 旦 进入 这 个 函数 ， 调 用 transaction 对 象 的 executeSql 方法 来 执行 一 个 标准 的 
CREATE TABLE 查询 语句 。 其 中 的 IF NOT EXISTS 子 句 避 免 在 数据 表 已 经 存在 的 情况 下 
再 次 创建 数据 表 。 

如 果 再 次 启动 程序 ， 会 在 Android 手机 上 创建 一 个 叫 作 123 的 数据 库 。 在 Chrome 的 
桌面 版 中 ， 实 际 上 是 可 以 浏览 并 且 操 作客 户 端的 数据 库 的 ， 只 需要 导航 到 View 一 
Developer 一 Developer Tools， 单 击 Storage 选项 。 在 Chrome Wo Developer Tools 
对 于 调试 来 说 相当 有 用 。 默 认 情况 下 ， 这 个 工具 栏 会 作为 浏览 器 的 一 个 面板 出 现 。 如 果 你 
点 击 浮动 图 标 (鼠标 在 左下 角 的 图 标 上 有 其 停 一 下 看 Paire 么 )， 这 个 面板 会 作为 
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一 个 独立 的 窗口 显示 。 通 过 点 击 数据 库 名 ， 这 个 界面 甚至 允许 执行 任意 的 SQL 查询 语句 。 


2. 插入 行 


现在 我 们 有 了 一 个 配置 好 的 数据 库 来 接收 数据 条 目 ， 可 以 生成 一 个 createEntry FR 2t 


了 。 首 先 ， 要 重 写 #createEntry 表单 的 提交 事件 ， 可 以 通过 将 createEntry0 函 数 和 123.js 中 


document ready 函数 的 提交 事件 绑 定 到 一 起 来 达成 此 目的 。 下 面具 显示 了 前 几 行 ， 
见 粗 体 代码 : 

$ (document) . ready (function () { 

$('#createEntry form') .submit (createEntry); 


$('#settings form').submit (saveSettings); 
$('#settings') .bind('pageAnimationStart', loadSettings); 


详情 参 


这 样 ， 每 次 用 户 提交 #createEntry 表单 ，createEntry0 函 数 就 会 被 调用 。 然 后 在 123.js 


中 添加 如 下 代码 来 在 数据 库 中 创建 记录 ; 


function createEntry() ( 

var date-sessionStorage.currentDate; VG) 
var calories=$('#calories') .val(); 

var food=$('#food"') .val(); 

db. transaction ( //(2) 
function (transaction) { 

transaction.executeSql( 

"INSERT INTO entries (date, calories, food) VALUES(?,?,?);', 
[date, calories, food], 

function()( 

refreshEntries(); 

JOT. goBack(); 

}, 

errorHandler 

) 7 

) 

ue 

return false; 


) 


(1) 这 部 分 包含 了 我 们 将 会 在 SQL 查询 语句 中 使 用 的 一 些 变量 。 前 面 讲 到 “将 选中 的 
数据 保存 到 sessionStorage 中 ”， 用 户 在 dates 面板 上 点 击 的 日 期 数据 已 经 保存 在 


sessionStorage.currentDate 中 。 使 用 之 前 需 在 settings 表单 中 用 相同 的 方法 从 表单 中 
外 两 个 值 (calories 和 food). 


PIRH 


(2) 这 段 代 码 打开 一 个 数据 库 事务 ， 并 且 执 行 executeSql0 调 用 。 这 时 我 们 传 入 


executeSql0) 方 法 的 4 个 参数 。 


Q "INSERT INTO entries (date, calories, food) VALUES(?.?.2):: 这 是 即将 被 执行 的 语 


句 。 问 号 代表 数据 占 位 符 。 


Q  [datecalories, food]: 这 个 数值 数组 将 被 传 入 数据 库 当中 ， 它 们 和 SQL 语句 中 的 


问号 占 位 符 一 一 对 应 。 
口 function() {refreshEntries():jQT.goBack();}: WE SQL 查询 语句 成 功 返 回 ， 


这 个 匿 
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名 函数 将 会 被 调用 。 

口 errorHandler: 如 果 SQL 语句 执行 失败 ， 这 是 将 会 被 执行 的 错误 处 理 函数 。 

假设 插入 数据 正确 ， 作 为 第 3 个 参数 的 匿名 函数 将 会 被 执行 。 这 个 函数 会 调用 
refreshEntries() 函 数 。 现 在 这 个 函数 只 能 更 新 date 面板 的 标题 ， 但 是 过 一 会 儿 就 会 看 到 创 
建 的 条 目 显示 在 列表 当中 ， 并 且 模 拟 在 Cancel 按钮 上 的 点 击 ， 关 闭 New Entry 面板 回 到 
date 面板 。 和 在 settings 面板 中 看 到 的 一 样 ，Cancel 按钮 不 会 取消 提交 动作 ， 它 只 是 一 个 
标 着 “Cancel” 的 返回 按钮 ， 不 过 长 得 不 像 一 个 左 箭头 。 

如 果 插 入 不 成 功 ，errorHandlerO 函 数 会 被 执行 。 在 文件 123.js 中 添加 如 下 代码 : 

function errorHandler(transaction, error)( 

alert('Oops. Error was'+error.message+' (Code'+error.codet+')"): 
return true; 

) 

这 个 错误 处 理 函 数 会 传 入 两 个 参数 : transaction 对 象 和 error 对 象 。 这 里 使 用 error 对 
象 来 提示 用 户 错误 信息 和 抛 出 的 错误 码 。 错 误 处 理 函数 必须 返回 true 或 false。 如 果 一 个 错 
误 处 理 函 数 返回 tue， 比 如 这 是 一 个 致命 的 错误 ， 执 行 过 程 会 被 停止 并 且 整 个 事务 将 会 回 
深 ， 如 果 错 误 处 理 函 数 返回 false， 比 如 这 不 是 一 个 致命 的 错误 ， 则 执行 过 程 会 继续 进行 。 

在 有 些 情 况 下 ， 可 能 需要 根据 不 同 的 错误 类 型 判断 返回 true 或 false。 其 实 除了 error 
对 象 以 外 ，errorHandler() 函 数 还 接收 了 一 个 transaction 对 象 。 可 以 想象 在 一 些 情况 下 ， 开 
发 人 员 需 要 在 错误 处 理 函 数 中 执行 SQL 语句 。 比 如 ， 将 错误 记录 到 日 志 ， 为 调试 记录 一 些 
元 数据 或 者 记录 前 溃 报 告 等 。 可 见 这 个 transaction 对 象 允许 更 多 的 来 自 错误 处 理 函数 内 六 
的 executeSql0 调 用 。 这 只 是 一 个 例子 ， 如 果 语 句 当 中 提 到 的 errors 表 没有 建立 的 话 ， 这 人 句 
将 不 会 执行 : 

function errorHandler (transaction, error)( 

alert('Oops. Error was'+error.message+' (Code'+error.code+-).); 

t ransaction.executeSql('INSERT INTO errors (code, message) 
VALUES (?,?);', 

[error.code,error.message]); 


return false; 
} 


有 一 点 要 特别 注意 如果 希望 执行 executeSql0 函 数 中 的 语句 ， 那 么 错误 处 理 函 数 必须 
返回 false。 如 果 返 回 的 是 true 或 者 没有 返回 值 ， 整 个 事务 (包括 错误 处 理 当中 的 这 条 SQL 
语句 ) 都 将 会 回 滨 ， 这 样 就 达 不 到 希望 的 效果 了 。 

3. 检索 行 及 处 理 结果 集 


下 面 需要 扩展 refreshEntries() 函 数 来 完成 更 多 功能 ， 而 不 只 是 将 选择 的 日 期 数据 更 新 
到 标签 栏 上 。 具 体 来 讲 ， 下 面 将 会 查询 数据 库 中 被 选择 的 日 期 条 目 ， 并 使 用 HTML 中 的 隐 
藏 entryTemplate 把 它们 添加 到 #date ul 元 素 中 。 在 这 里 把 date 面板 中 的 代码 再 次 展示 出 
来 ， 因 为 它们 已 经 在 文件 index.html 中 了 ， 所 以 无 须 添加 。 
<div id="date"> 
<div class="toolbar"> 
<hl>Date< /hl> 
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<a class="button back" href="#">Back</a> 

<a class="button slideup"href="#createEntry">+</a> 
</div> 

<ul class="edgetoedge"> 

<li id="ent ryTemplate"class-"entry"style-"display:none"» 
<span class="label">Label</span> 

<span class="calories">000</span> 

<span class="delete">Delete</span> 

</li> 

</ul> 

</div> 


注意 上 面 的 加 粗 代 码 : n 元 素 的 样式 属性 已 经 设置 成 display:none， 这 会 使 该 元 素 不 在 
页 面 上 显示 出 来 。 这 样 做 是 因为 使 用 了 HTML 代码 段 作 为 数据 库 行 显示 的 模板 。 

下 面 是 完整 的 refreshEntries() 函 数 ， 需 要 将 文件 123.js 中 现 有 的 refreshEntries0) 的 代码 
Tif un FARI: 


function refreshEntries() ( 


var currentDate-sessionStorage.currentDate; // (1) 
$('#date hl') .text (currentDate) ; 

$('£date ul ti:gt(0) ').remove(); //(2) 
db.transaction( // (3) 


function(transaction) { 
transaction.executeSql( 


"SELECT*FROM entries WHERE date=7 ORDER BY food;', //(4) 
[currentDate], //(5) 
function (transaction.result) { //(6) 

for (var i-0;i«result.rows.length; i++) { 

var row-result.rows.item(i); TAA GTP 

var newEntryRow=$ ('fentryTemplate').clone(); //(8) 


newEntryRow. removeAttr('id'); 

newEntryRaw.removeAttr('style'); 
newEntryRow.data('entryId'.row.id); //(9) 
newEntryRow.appendTo('#date uI'); // (10) 
newEntryRow.find('*label').text (row. food) ; 
newEntryRow.find('.calories').text(row.calories); 

H 

) ， 

errorHandler 

Ja 

) 

); 

i 


(1) 这 两 行 代 码 用 sessionStorage 中 保存 的 currentDate 值 来 设置 date 面板 中 的 标 


(2) 这 一 行使 用 jQTouch 的 gt0 函 数 (gt 代表 “greater than”) 来 查找 并 移 除 任何 索引 大 
于 0 的 五 元 素 。 尽 管 这 个 函数 第 一 次 不 会 起 作用 ， 但 因为 只 有 一 个 ID 为 entryTemplate 的 
li 元 素 ， 它 的 索引 为 0 并 且 是 隐藏 的 ， 当 后 续 访问 该 页 面 时 ， 就 需要 将 数据 库 中 的 数据 添 
加 到 t 元 素 之 前 ， 将 原 有 的 数据 删除 。 否 则 数据 记录 会 在 列表 中 出 现 多 次 ， 因 为 相同 的 数 
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据 将 会 一 遍 又 一 遍地 添加 进 列表 。 

(3) 这 3 行 设置 数据 库 事务 和 executeSql 函数 。 

(4) 本 行 包含 了 executeSql 函数 的 第 一 个 参数 。 它 是 一 个 简单 的 SELECT 语句 ， 问 号 
代表 一 个 数据 占 位 符 。 

(5) 这 是 只 有 一 个 元 素 的 数组 ， 包 含 了 现 有 被 检索 到 的 数据 。 在 SQL 查询 语句 中 ， 问 
号 将 会 被 该 元 素 代 替 。 

(6) 当 正 确 的 查询 完成 时 这 个 匿名 函数 将 被 调用 。 它 接收 两 个 参数 : transaction 和 
result。 成 功 处 理 函 数 中 的 transaction 对 象 将 向 数据 库 发 送 新 的 查询 请 求 ， 这 和 之 前 的 错误 
处 理 函数 一 样 。 然 而 ， 在 当下 不 必 那 样 ， 所 以 这 里 不 会 用 transaction 对 象 。 

此 处 的 result 对 象 有 3 个 只 读 属 性 。 

Q rowsAffected: 用 来 判断 插入 、 更 新 和 删除 查询 过 后 被 影响 的 行 数 。 

口 linsertId: 返回 在 插入 操作 中 最 后 一 条 被 插入 行 的 主键 值 。 

Q rows: 代表 被 查询 到 的 记录 。rows 对 象 包含 0 个 或 者 多 个 row 对 象 ， 并 且 包 含 一 

个 length 属性 ， 在 下 面 的 for 循环 代码 中 可 以 看 到 。 

(7) 本 行使 用 rows 的 item() 方 法 把 查询 到 的 行 的 内 容 设 置 到 row 变量 中 。 

(8) 这 行 代码 中 ， 使 用 clone0 方 法 来 复制 模板 i， 并 且 在 下 两 行 中 删除 掉 它 的 id 和 
style 属性 。 删 除 掉 style 属性 会 使 这 行 可 见 ， 而 删除 掉 id 是 很 重要 的 ， 否 则 在 页 面 的 结尾 
就 会 出 现 多 个 相同 id 的 数据 项 。 

(9) 本 行 中 将 row 的 id 属性 作为 数据 存 入 元 素 中 ， 需 要 这 个 数据 以 便 在 删除 的 时 候 
知道 这 是 哪 条 记录 。 

(10) 这 行 代码 将 1 元素 加 入 其 父 元 素 uI 当中 。 接 下 来 的 两 行 用 row 中 相应 的 数据 更 
新 11 的 子 元 素 label 和 calories. 

当 这 些 都 做 完 以 后 ，date 面板 会 对 从 数据 库 中 检索 出 来 的 数据 ， 每 一 行 显示 一 个 di 76 
素 。 每 一 行 都 有 一 个 lable, calories 和 Delete 按钮 。 如 果 再 创建 一 些 行 ， 就 需要 加 上 
CSS， 让 界面 变 得 更 美观 一 些 。 所 以 将 下 面 的 CSS 代码 保存 到 123.css 文件 中 ， 注 意 将 这 
个 文件 放 在 和 HTML 同一 层 目录 下 。 

#date ut li( 
position:relative; 
) 
#date ul li span{ 
color: £FFFFFF; 
text-shadow:0 lpx 2px rgba(0,0,0,.7); 
) 
#date ul li.delete { 
position: absolute; 
top: 5px; 
right: 6px; 
font-size: 12px; 
line-height: 30px; 
padding: 0 3px; 
border-width: 0 5px; 
-webkit-barder-image: url(themes/jqt/img/button.png) 0 5 0 5; 
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然后 在 文件 mdex.html 的 head 部 分 添加 如 下 代码 以 便 连 接 到 123.css。 


<link type-"text/css"rel-"stylesheet"media-"sc reen"href="123.css"> 


4. 删除 行 


虽然 现在 Delete 按钮 看 起 来 更 像 一 个 按钮 了 ， 但 单 击 这 些 按钮 时 ， 它 们 没有 任何 反 
应 。 这 是 因为 它们 是 使 用 span 标签 来 实现 的 按钮 ， 在 HTML 页 面 中 是 一 个 无 法 交互 的 
元 素 。 

为 了 让 Delete 按钮 起 作用 ， 需 要 使 用 jQuery 将 它们 和 点 击 事件 绑 定 起 来 。 在 之 前 处 理 
date 面板 中 的 条 目 时 做 过 类 似 的 事情 ， 用 的 就 是 jQuery 的 clickO 函 数 。 可 惜 的 是 ， 这 种 方 
法 在 这 里 行 不 通 。 与 dates 面板 中 的 条 目 不 同 ，date 面板 中 的 条 目 不 是 静态 的 ， 这 说 明 它 
们 的 添加 和 删除 和 用 户 的 session 相关 。 事 实 上 ， 当 程序 启动 时 ，date 面板 上 并 没有 可 见 的 
条 目 ， 因 此 也 没有 什么 可 以 绑 定 到 click 事件 上 。 

解决 方案 是 当 Delete 按钮 在 refreshEntries() 函 数 被 创建 时 ， 将 它们 绑 定 到 click 事件 
上 。 为 了 做 到 这 点 ， 需 要 在 for 循环 的 最 后 添加 如 下 加 粗 的 代码 : 


newEnt ryRow.find('.calories').text( row.calories); 


newEntryRow.find('.delete').click(function()( //0) 
var clickedEntry-$ (this) .parent() ; //(2) 
var clickedEntryId=clickedEntry.data('entryId') ; //(3) 
deleteEntryById (clickedEntryId); //(4) 
clickedEntry.slideUp(); 

H); 

) 


(1) 这 个 函数 指 在 date 元 素 的 ID 中 寻找 任何 有 delete 这 个 类 的 元 素 ， 并 设置 它们 的 
clickO 函 数 。 这 个 clickO 函 数 允 许 用 一 个 匿名 函数 作为 参数 来 处 理 点 击 事件 。 
(2) 当 click 事件 被 触发 以 后 ，Delete 按钮 的 父 元 素 ( 这 里 是 可 被 找到 ， 然 后 被 保存 进 


clickedEntry 变量 。 
(3) 这 行 代 码 使 用 refreshEntriesO 函 数 创 建 的 二 元素 保存 的 entryId 值 来 设置 
clickedEntryId 变量 。 


(4) 这 行 代码 将 被 点 击 元 素 的 ID 传 入 deleteEntryById0 函 数 中 ， 接 下 来 的 一 行 调用 
jQuery 的 slideUpO 函 数 很 好 地 将 下 元 素 从 界面 上 移 除 。 
在 文件 123 js 中 添加 deleteEntryById0 函 数 ， 使 得 从 数据 库 中 移 除 一 条 记录 。 


function deleteEntryById(id) { 

db.transaction( 

function (transaction) { 

transaction.executeSql('DELETE FROM entries WHERE id=?;' 
[id], null, errorHandler); 

} 

JE 

) 


依照 前 一 个 例子 中 的 做 法 ， 打 开 一 个 事务 ， 并 将 一 个 参数 为 transaction 对 象 的 回调 函 
数 作为 参数 传 入 transaction 中 ， 然 后 执行 executeSql0 方 法 。 方 法 中 SQL 查询 语句 和 被 点 
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击 记录 的 ID 作为 两 个 参数 传 入。 第 3 个 参数 是 成 功 处 理 函数 ， 但 是 不 需要 ， 所 以 指定 为 
null。 而 第 4 个 参数 ， 我 们 将 其 指定 为 一 直 使 用 的 错误 处 理 函 数 。 这 就 是 整个 例子 。 虽 然 
用 了 很 多 描述 才 完 成 这 项 功能 ， 但 实际 上 代码 并 不 多 。 文 件 123.js 只 包含 了 差不多 100 行 
JavaScript 代码 。 

下 面 演示 了 123 与 数据 库 交互 的 全 部 JavaScript 代码 清单 


var jQT=$.jQTouch (t 
icon: '123.png" 
); 
var db; 
$ (document) . ready (function () { 
$('#createEntry form') .submit (createEntry); 
$('£settings form').submit( saveSettings); 
$('#settings') .bind('pageAnimationStart', loadSettings); 
$("#dates li a').click(function()( 
var dayOffset=this.id; 
var date-new Date(); 
date.setDate (date.getDate () -dayOffset); 
sessionStorage.currentDate=date.getMonth()+1+'/'+ 
date.getDate() + '/l + 
date.getFullYear(); . 
refreshEntries(); 


); 


var shortName = '123'; 
var version - '1.0'; 
var displayName - '123'; 


var maxSize = 65536; 
db = openDatabase(shortName, version, displayName, maxSize); 
db.transaction( 
function(transaction) ( 
transaction.executeSql ( 
"CREATE TABLE IF NOT EXISTS entries. + 
d (id INTEGER NOT NULL PRIMARY KEY AUTOINCREMENT, ' + 
i date DATE NOT NULL, food TEXT NOT NULL, . + 
a calories INTEGER NOT NULL) ; ' 


); 

function loadSettings() t 
$( '#age') .val(localStorage.age) ; 
$( '#budget') .val (localStorage.budget) 
$( '#weight") .val (localStorage.weight) 


} 
function saveSettings() { 
localStorage.age = $('#age') .val() ; 
localStorage.budget = $( '#budget') .val() ; 
localStorage.weight = $( '#weight') .val() ; 
jOT.goBack() ; 
return false, 


Andicid 54555283 


} 
function createEntry () { 
var date=sessionStorage. currentDate . 
vat calories = $( '#calories') .val() i 
var food = $('#food"') .val(); 
db. transaction ( 
function(transaction) { 
transaction.executeSql( 
'INSERT INTO entries(date, calories, 
food)VALUES(?, ?, ?);', 
[date, calories, foodl, 


function () { 
refreshEnt ries () ; 
jOT.goBack() ; 
), 
errorHandler 


); 
return false, 
) 
function refreshEntries()( 
var currentDate-sessionStorage. currentDate , 
$( '#date hi') .text (currentDate) ; 
$( '#date ul li:gt (0) ' ) . remove () ; 
db.transaction( 
fulclction(transaction) ( 
transaction. executeSql ( 
'SELECT* FROM entries WHERE date = ? ORDER BY food;', 
[currentDate], 
function (transaction, result)( 
for(var i-o; i«result.rows.length; i++) { 
var row:result.rows.item(i); 
var newEntryRow-$( '#entryTemplate') .clone() 
newEnt ryRow. removeAtt r( 'id ') ， 
newEnt ryRow. removeAttr( 'style') ; 
newEntryRow.data( 'entryld', row.id) ; 
newEntryRow.appendTo( '#date ul')i 
newEntryRow.find('.label').text( row.food) , 
newEntryRow.find( ' .calo ries') .text ( row.calo ries) ; 
newEnt ryRow.find ( '.delete').click(function() ( 
var clickedEntry - $(this).parent(); 
var clickedEntryId = clickedEntry.data('entryId); 
deleteEnt ryById ( clickedEnt ryId)* 
clickedEntry.slideUp(); 
n; 


ty 
errorHandler 
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B 
function deleteEntryById(id) ( 
db.transaction ( 
function(transaction) ( 
transaction.executeSql('DE LETE FROM entries WHERE id-?;', 
Lidl, null, errorHandler); 


function errorHandler(transaction, error) ( 
alert('Oops.Error was '+error.message+' (Code '+error.code+')'); 
return.true, 


SES 
WebKit ie] V BE VE AF 


WebKit Æ Android 系统 的 内 置 浏览 器 ， 是 一 个 开源 的 浏览 
器 网 页 排版 引擎 ， 包 含 WebCore 排版 引擎 和 JSCore 引擎 。 
WebCore 和 JSCore 引擎 来 自 于 KDE 项 目的 KHTML 和 KJS 开 
源 项 目 。Android 平台 的 Web 引擎 框架 采用 了 WebKit 项 目 中 
的 WebCore 和 JSCore 部 分 ， 上 层 由 Java 语言 封装 ， 并 且 作 为 
API 提供 给 Android 应 用 开发 者 ， 而 底层 使 用 WebKit 核心 库 
(WebCore 和 JSCore) 进 行 网 页 排版 。 本 章 将 详细 讲解 WebKit 
浏览 器 的 基本 知识 ， 为 读者 步 入 本 书后 面 知 识 的 学 习 打 下 基础 。 
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6.1 WebKit 的 目录 结构 


Android 平台 的 WebKit 模块 分 为 Java 层 和 WebKit 库 两 个 部 分 ， 其 目录 结构 如 表 6-1 
所 示 。 


表 6-1 WebKit 的 目录 结构 


目录 说 明 

Java 层 ( 根 目录 是 device\java\android\android\webkit) 
BrowserFrame 对 象 是 对 WebCore 库 中 的 Frame 对 象 的 Java 层 封装 ， 用 
BrowserFrame.java 于 创建 WebCore 中 定义 的 Frame， 以 及 为 该 Frame 对 象 提供 Java 层 回 
调 方法 

ByteArrayBuilder java ByteArrayBuilder 辅助 对 象 ， 用 于 byte 块 链表 的 处 理 
URL Cache 载 入 器 对 象 ， 该 对 象 实现 StreadLoader 抽象 基 类 ， 用 于 通过 
CacheResult 对 象 载 入 内 容 数据 

CacheManager.java Cache 管理 对 象 ， 负 责 Java 层 Cache 对 象 管理 
Cache 同步 管理 对 象 ， 负 责 同步 RAM 和 Flash 之 间 的 浏览 器 Cache 数 
据 。 实 际 的 物理 数据 操作 在 WebSyncManager 对 象 中 完 
该 对 象 是 用 于 处 理 WebCore 与 UI 线程 消息 的 代理 类 。 当 有 Web 事件 
CallbackProxy.java 产生 时 ，WebCore 线程 会 调用 该 回调 代理 类 ， 代 理 类 会 通过 消息 的 方 
式 通 知 UU 线程 ， 并 且 调 用 设置 的 客户 对 象 的 回调 函数 
CellList 定义 图 片 集合 中 的 Cell， 管 理 Cell 图 片 的 绘制 、 状 态 改变 以 及 


CachLoader.java 


CacheSyncManager.java 


CellList.java 索引 

CookieManager java 根据 RFC2109 规范 来 管理 Cookies 

Cookes no as Cookies 同步 管理 对 象 ， 该 对 象 负责 同步 RAM 和 Flash 之 间 的 Cookies 
数据 。 实 际 的 物理 数据 操作 在 基 类 WebSyncManager 中 完成 

DataLoader java 数据 载 入 器 对 象 ， 用 于 载 入 网 页 数据 

DateSorter java 尚未 使 用 

DownloadListener.java 下 载 侦 听 器 接口 


下 载 管理 器 对 象 ， 管 理 下 载 列表 。 该 对 象 运行 在 WebKit 的 线程 中 ， 通 


DownloadManagerCore.java | 、 RERNE: 
过 CallbackProxy 对 象 与 UI 线程 交互 


FileLoader.java 文件 载 入 器 ， 将 文件 数据 载 入 到 Frame 中 
FrameLoader.java Frame 载 入 器 ， 用 于 载 入 网 页 Frame 数据 


Htp 认证 处 理 对 象 ， 该 对 象 会 作为 参数 传递 给 


HttpAuthHandlerjava 和 

BrowserCallback.displayHttpAuthDialog 方法 ， 与 用 户 交 互 
HttpDataTime.java 该 对 象 是 处 理 HITP 日 期 的 辅助 对 象 
JsConfirmResult.java JS 确认 请 求 对象 
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续 表 
B® 说 AA 
JsPromptResult.java JS 结果 提示 对 象 ， 用 于 向 用 户 提示 JavaScript 运行 结果 
JsResult java JS 结果 对 象 ， 用 于 实现 用 户 交互 
JWebCoreJavaBridge.java 用 Java 与 WebCore 库 中 Timer 和 Cookies 对 象 交 互 的 桥接 代码 
LoadListener java 载 入 器 侦 听 器 ， 用 于 处 理 载 入 器 侦 听 消息 
Network.java 该 对 象 封 装 网 络 连接 逻辑 ， 为 调用 者 提供 更 为 高 级 的 网 络 连接 接口 
PanZoom.java 用 于 处 理 图 片 缩放 、 移 动 等 操作 
PanZoomCellListjava 用 于 保存 移动 、 缩 放 图 片 的 Cell 
SslErrorHandler java 用 于 处 理 SSL 错误 消息 
EE TE StreamLoader 抽象 类 是 所 有 内 TS BOUES. 该 类 是 通过 消息 方 
式 控制 的 状态 机 ， 用 于 将 数据 载 入 到 Frame 中 
d ! 用 于 处 理 HTML 中 文本 区 域 车 加 情况 ， 可 以 使 用 标准 的 文本 编辑 而 定 
TextDialog.java E i : 
义 的 特殊 EditText 控件 
URL 处 理 功 能 函数 ， 用 于 编码 、 解 码 URL 字符 串 ， 以 及 提供 附加 的 
URLUtil.java 


URL 类 型 分 析 功 能 


WebBackForwardList.java 该 对 象 包含 WebView 对 象 中 显示 的 历史 数据 


WebBackForwardList- 浏览 历史 处 理 的 客户 接口 类 ， 所 有 需要 接收 浏览 历史 改变 的 类 都 需要 实 
Clientjava 现 该 接口 

"o Chrome 客户 基 类 ，Chrome 客户 对 象 在 浏览 器 文档 标题 、 进 度 条 、 图 标 
WebChromeClient.java 改变 时 会 得 到 通知 
WebHistoryItem.java 该 对 象 用 于 保存 一 条 网 页 历史 数据 


WebIconDataBase.java 


图 表 数 据 库 管理 对 象 ， 所 有 的 WebView 均 请 求 相同 的 图 标 数 据 库 对 象 


WebsSettings.java 


WebView 的 管理 设置 数据 ， 该 对 象 数据 是 通过 JNI 接口 从 底层 获取 


WebSyncManager java 数据 同步 对 象 ， 用 于 RAM 数据 和 Flash 数据 的 同步 操作 


WebView.java 


Web 视图 对 象 ， 用 于 基本 的 网 页 数据 载 入 、 显 示 等 可 操作 


WebViewcClient.java Web 视图 客户 对 象 ， 在 Web 视图 中 有 事件 产生 时 ， 该 对 象 可 以 获得 通知 
该 对 象 对 WebCore 库 进行 了 封装 ， 将 UI 线程 中 的 数据 请 求 发 送 给 

WebViewCore java WebCore 处 理 ， 并 且 通 过 CallbackProxy 的 方式 ， 通 过 消息 通知 UI 线 
程 数 据 处 理 的 结果 

WebViewDatabasejava 该 对 象 使 用 SQLiteDatabase 为 WebCore 模块 提供 数据 存 取 操作 


Android 平台 的 WebKit 系统 是 由 Java 层 和 WebKit 库 两 个 部 分 组 成 ， 其 中 Java 
责 与 Android 应 用 程序 进行 通信 ， 而 WebKit 类 库 负 责 实际 的 网 页 排版 处 理 。Java 


6.2 WebKit 框架 介绍 


层 负 
层 和 C 


层 库 之 间 通 过 INI Bridge 相互 调用 ， 如 图 6-1 所 示 。 


Request[API] 


Invoke Java Method 


WebKit[CPP] 


图 6-1 WebKit 系 统 框架 结构 
6.2.1 Java 层 框架 


1. 主要 类 

WebKit 模块 的 Java 层 一 共 由 41 个 文件 组 成 ， 其 中 主要 类 的 具体 说 明 如 下 。 

1) WebView 

类 WebView 是 WebKit 模块 Java 层 的 视图 类 ， 所 有 需要 使 用 Web 浏览 功能 的 
Android 应 用 程序 都 要 创建 该 视图 对 象 显示 和 处 理 请 求 的 网 络 资源 。 目 前 ，WebKit 模块 支 
持 HTTP. HTTPS, FTP 以 及 JavaScript 请 求 。WebView 作为 应 用 程序 的 UI 接口 ， 为 用 
户 提供 了 一 系列 的 网 页 浏览 、 用 户 交互 接口 ， 客 户 程序 通过 这 些 接口 访问 WebKit 核心 


代码 。 

WebView 是 一 个 非常 重要 的 类 ， 能 够 实现 和 网 络 有 关 的 很 多 功能 ， 在 本 章 后 面 的 内 容 
中 将 重点 介绍 。 

2) WebViewDatabase 


WebViewDatabase 是 WebKit 模块 中 针对 SQLiteDatabase 对 象 的 封装 ， 用 于 存储 和 获 
取 运 行 时 浏览 器 保存 的 缓冲 数据 、 历 史 访 问 数据 、 浏 览 器 配置 数据 等 。 该 对 象 是 一 个 单 实 
例 对 象 ， 通 过 getInstance 方法 获取 WebViewDatabase 的 实例 。WebViewDatabase 是 
WebKit 模块 中 的 内 部 对 象 ， 仅 供 WebKit 框架 内 部 使 用 。 

3) WebViewCore 

WebViewCore 类 是 Java 层 与 C 层 WebKit 核心 库 的 交互 类 ， 客 户 程序 调用 WebView 
的 网 页 浏览 相关 操作 会 转发 给 BrowserFrame 对 象 。 当 WebKit 核心 库 完 成 实际 的 数据 分 析 
和 处 理 后 会 回调 WebViweCore 中 定义 的 一 系列 JNI 接口 ， 这 些 接口 会 通过 CallbackProxy 
将 相关 事件 通知 相应 的 UI 对象 。 

4) CallbackProxy 

CallbackProxy 是 一 个 代理 类 ， 用 于 实现 UI 线程 和 WebCore 线程 之 间 的 交互 。 类 
CallbackProxy 定义 了 一 系列 与 用 户 相关 的 通知 方法 ， 当 WebCore 完成 相应 的 数据 处 理 后 
会 调用 CallbackProxy 类 中 对 应 的 方法 ， 这 些 方法 通过 消息 方式 间接 调用 相应 处 理 对 象 的 
处 理 方法 。 
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5) BrowserFrame 
BrowserFrame 类 负责 URL 资源 的 载 入 、 访 问 历史 的 维护 、 数 据 缓存 等 操作 ， 该 类 会 
通过 JNI 接口 直接 与 WebKit C 层 库 交 互 。 


6) JWebCoreJavaBridge 

类 JWebCoreJavaBridge 为 Java 层 WebKit 代码 提供 与 C 层 WebKit 核心 部 分 的 Timer 
和 Cookies 操作 相关 的 方法 。 

7) DownloadManagerCore 


类 DownloadManagerCore 是 一 个 下 载 管理 核心 类 ， 主 要 负责 管理 网 络 资源 的 下 载 ， 所 
有 的 Web 下 载 操作 均 有 该 类 统一 管理 。 该 类 实例 运行 在 WebKit 线程 当中 ， 与 UI 线程 的 
交互 是 通过 调用 CallbackProxy 对 象 中 相应 的 方法 完成 。 

8) WebSettings 

WebSettings 描述 了 Web 浏览 器 访问 相关 的 用 户 配置 信息 。 

9) DownloadListener 

DownloadListener 负责 下 载 侦 听 接口 ， 如 果 客 户 代码 实现 该 接口 ， 则 在 下 载 开始 、 失 
败 、 挂 起 、 完 成 等 情况 下 ，DownloadManagerCore 对 象 会 调用 客户 代码 中 实现 的 
DownloadListener 方法 。 

10) WebBackForwardList 

WebBackForwardList 负责 维护 用 户 访问 的 历史 记录 ， 该 类 为 客户 程序 提供 操作 访问 浏 
览 器 历史 数据 的 相关 方法 。 

11) WebViewClient 

在 类 WebViewClient 中 定义 了 一 系列 事件 方法 ， 如 果 Android 应 用 程序 设置 了 
WebViewClient 派生 对 象 ， 则 在 页 面 载 入 、 资 源 载 入 、 页 面 访问 错误 等 情况 发 生 时 ， 该 派 
生 对 象 的 相应 方法 会 被 调用 。 

12) WebBackForwardListClient 

WebBackForwardListClient 定义 了 对 访问 历史 操作 时 可 能 产生 的 事件 接口 ， 当 用 户 实 
现 了 该 接口 ， 则 在 操作 访问 历史 (访问 历史 移 除 、 访 问 历史 清空 等 ) 时 用 户 会 得 到 通知 。 

13) WebChromeClient 

类 WebChromeClient 定义 了 与 浏览 窗口 修饰 相关 的 事件 。 例 如 接收 到 Title. Icon, X 
度 变 化 时 ，WebChromeClient 的 相应 方法 会 被 调用 。 


2. 数据 载 入 器 的 设计 理念 


在 WebKit 系统 的 Java 部 分 框架 中 ， 使 用 数据 载 入 器 来 加 载 相应 类 型 的 数据 ， 目 前 有 
CacheLoader、DataLoader 以 及 FileLoader 三 类 载 入 器 ， 它 们 分 别 用 于 处 理 缓存 数据 、 内 存 
数据 ， 以 及 文件 数据 的 载 入 操作 。Java 层 (WebKit 模块 ) 所 有 的 载 入 器 都 从 StreamLoader 继 
承 (其 父 类 为 Handler), HF StreamLoader 类 的 基 类 为 Handler 类 ， 因 此 在 构造 载 入 器 时 ， 
会 开启 一 个 事件 处 理 线程 ， 该 线程 负责 实际 的 数据 载 入 操作 ， 而 请 求 线程 通过 消息 的 方式 
驱动 数据 的 载 入 。 图 6-2 描述 了 数据 载 入 器 相关 类 的 类 图 结构 。 


网 络 开发 从 入 门 到 精通 


CacheLoader 


图 6-2 数据 载 入 器 的 类 图 结构 

在 类 StreamLoader 中 定义 了 以 下 4 个 不 同 的 消息 。 

OQ MSG STATUS: 表示 发 送 状态 消息 。 

O MSG HEADERS: 表示 发 送 消息 头 消息 。 

O MSG DATA: 表示 发 送 数据 消息 。 

Q MSG END: 表示 数据 发 送 完毕 消息 。 

在 类 StreamLoader 中 提供 了 两 个 抽象 保护 方法 以 及 一 个 公有 方法 ， 其 中 保护 方法 
setupStreamAndSendStatus 用 于 构造 与 通信 协议 相关 的 数据 流 ， 以 及 向 LoadListener 发 送 状 
态 。 保 护 方法 buildHeaders 负责 向 子 类 提供 构造 特定 协议 消息 头 功能 。 所 有 载 入 器 只 有 一 
个 共有 方法 (load)， 因 此 当 需 要 载 入 数据 时 ， 只 需 调 用 该 方法 即 可 。 与 数据 载 入 流程 相关 的 
类 还 有 LoaderListener 以 及 BrowserFrame， 当 数据 载 入 事件 发 生 时 ，WebKit C 库 会 更 新 载 
入 进度 ， 并 且 会 通知 BrowserFrame ，BroserFrame 接收 到 进度 条 变更 事件 后 会 通过 
CallbackProxy 对 象 ， 通 知 View 类 进度 条 数据 变更 。 


6.22 CHIER 


因为 C 层 框架 属于 Android 体系 底层 的 知识 ， 而 我 们 本 书 主要 讲解 Android 在 Java 
:发 网 络 应 用 的 知识 ， 所 以 在 此 简要 介绍 WebKit AZ C 层 框架 的 基本 知识 ， 只 简单 分 析 
C 层 框架 中 各 个 类 之 间 的 关系 。 读 者 了 解 了 这 些 类 之 间 的 关系 和 原理 后 ， 当 在 Java 层 中 开 
发 应 用 时 即 可 “ 游 思 有 余 ”。 
1. C 层 类 和 Java 层 的 关系 


FileLoader 


NI 


1) BrowserFrame 

与 BrowserFrame Java 类 相对 应 的 C++ 类 为 FrameBridge， 该 类 为 Dalvik 虚拟 机 回调 
BrowserFrame 类 中 定义 的 本 地 方法 进行 了 封装 。 与 BrowserFrame 中 回调 函数 (Java 层 ) 相 对 
应 的 C 层 结构 定义 代码 如 下 。 
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struct FrameBridge::JavaBrowserFrame 
{ 
JavaVM* mJVM; 
jobject  mObj; 
jmethodID mStartLoadingResource; 
jmethodID mLoadStarted; 
jmethodID mUpdateHistoryForCommit; 
jmethodID mUpdateCurrentHistoryData; 
jmethodID mReportError; 
jmethodID setTitle; 
jmethodID mWindowObjectCleared; 
jmethodID mDidReceiveIcon; 
jmethodID mUpdateVisiteHistory; 
jmethodID mHandleUrl; 
jmethodID mCreateWindow; 
jmethodID mCloseWindow; 
jmethodID mDecidePolicyForFormResubmission; 
u 
上 述 结构 作为 FrameBridge(C 层 ) 的 一 个 成 员 变量 (mJavaFrame)， 在 FrameBridge 构造 
函数 中 ， 用 BrowserFrame(Java 层 ) 类 的 回调 方法 的 偏 移 量 初始 化 JavaBrowserFrame 结构 的 
各 个 域 。 初 始 化 后 ， 当 WebCore(C 层 ) 在 剖析 网 页 数据 时 ， 有 Frame 相关 的 资源 改变 ， 比 
如 Web 页 面 的 主题 变化 ， 则 会 通过 mJavaFrame 结构 ， 调 用 指定 BrowserFrame 对 象 的 相 
应 方法 ， 通 知 Java 层 处 理 。 
2) JWebCoreJavaBridge 
与 JWebCoreJavaBridge 对 象 相对 应 的 C 层 对 象 为 JavaBridge, JavaBridge 对 象 继 承 了 
TimerClient 和 CookieClient 类 ， 负 责 WebCore 中 的 定时 器 和 Cookie 管理 。 与 Java 层 
JWebCoreJavaBridge 类 中 方法 偏 移 量 相关 的 是 JavaBridege 中 的 几 个 成 员 变量 ， 在 构造 
JavaBridge 对 象 时 ， 会 初始 化 这 些 成 员 变量 ， 之 后 有 Timer 或 者 Cookies 事件 产生 ， 
WebCore 会 通过 这 些 ID 值 ， 回 调 对 应 JWebCoreJavaBridge 的 相应 方法 。 
3) LoadListener 
与 LoadListener 对 象 相关 的 C 层 结构 是 struct resourceloader t， 该 结构 保存 了 
LoadListener 对 象 ID 、CancelMethod ID 以 及 DownloadFileMethod ID 值 。 当 有 Cancel 或 者 
Download 事件 产生 ，WebCore 会 回调 LoadListener 类 中 的 CancelMethod 或 者 
DownloadFileMethod . 
4) WebViewCore 
Lj WebViewCore 相关 的 C 类 是 WebCoreViewImpl, WebCoreImplView 类 有 个 
JavaGlue 对 象 作为 成 员 变 量 ， 在 构建 WebCoreViewImpl 对 象 时 ， 用 WebViewCore(Java Jz) 
中 的 方法 ID 值 初始 化 该 成 员 变量 ， 并 且 会 将 构建 的 WebCoreViewImpl 对 象 指针 赋值 给 
WebViewCore(Java 层 ) 的 mNativeClass , XX FÉ 将 WebViewCore(Java 层 fil 
WebViewCoreImpl(C 层 ) 关 联 起 来 。 
5) WebSettings 
与 WebSettings 相关 的 C 层 结构 是 struct FieldIds， 该 结构 保存 了 WebSettings 类 中 定义 
的 属性 ID 以 及 方法 D, Æ WebCore 初始 化 (WebViewCore 的 静态 方法 中 使 用 
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System.loadLibrary 载 入 ) 时 会 设置 这 些 方法 和 属性 的 ID 值 。 

6) WebView 

与 WebView 相关 的 C 层 类 是 WebViewNative， 该 类 中 的 mJavaGlue 中 保存 着 
WebView 中 定义 的 属性 和 方法 ID, YE WebViewNative 构造 方法 中 初始 化 ， 并 且 将 构造 的 
WebViewNative 对 象 的 指针 赋值 给 WebView 类 的 mNativeClass 变量 ， 这 样 WebView 和 
WebViewNative 对 象 建立 了 关系 。 


2. 与 Java 层 相关 的 C 层 类 
下 面 总 结 与 Java 层 相 关 的 C 层 类 ， 具 体 信息 如 下 。 


a 


ChromeClientAndroid: 该 类 主要 处 理 WebCore 中 与 Frame 装饰 相关 的 操作 。 例 如 
设置 状态 栏 、 滚 动 条 、JavaScript 脚本 提示 框 等 。 当 浏览 器 中 有 相关 事件 产生 
时 ，ChromeClientAndroid 类 的 相应 方法 会 被 调用 ， 该 类 会 将 相关 的 UI 事件 通过 
Bridge 传递 给 Java 层 ， 由 Java 层 负责 绘制 以 及 用 户 交互 方面 的 处 理 。 
EditorClientAndroid: 该 类 负责 处 理 页 面 中 文本 相关 的 处 理 ， 比 如 文本 输入 、 取 
消 、 输 入 法 数据 处 理 、 文 本 粘贴 、 文 本 编辑 等 操作 。 不 过 目前 该 类 只 对 按键 相关 
的 时 间 进 行 了 处 理 ， 其 他 操作 均 未 支持 。 

ContextMenuClient: 该 类 提供 页 面相 关 的 功能 菜单 ， 比 如 图 片 拷贝 、 朗 读 、 查 找 
等 功能 。 但 是 ， 目 前 项 目 中 未 实现 具体 功能 。 

DragClient: 该 类 定义 了 与 页 面 拖 忠 相关 的 处 理 ， 但 是 目前 该 类 没有 实现 具体 功能 。 
FrameLoaderClientAndroid: 该 类 提供 与 Frame 加 载 相 关 的 操作 ， 当 用 户 请 求 加 载 
-个 页 面 时 ，WebCore 分 析 完 网 页 数据 后 ， 会 通过 该 类 调用 Java 层 的 回调 方法 ， 

通知 UI 相关 的 组 件 处 理 。 

InspectorClientAndroid: 该 类 提供 与 窗口 相关 的 操作 ， 比 如 窗口 显示 、 关 闭 窗 
口 、 附 加 窗口 等 。 不 过 目前 该 类 的 各 个 方法 均 为 空 实现 。 

Page: 该 类 提供 与 页 面相 关 的 操作 ， 比 如 网 页 页 面 的 前 进 、 后 退 等 操作 。 
FrameAndroid: 该 类 为 Android 提供 Frame 管理 。 

FrameBridge: 该 类 对 Frame 相关 的 Java 层 方法 进行 了 封装 ， 当 有 Frame 事件 产 
生 时 ，WebCore 通过 FrameBridge 回调 Java 的 回调 函数 ， 完 成 用 户 交 互 过 程 。 
AssetManager: 该 类 为 浏览 器 提供 本 地 资源 访问 功能 。 

RenderSkinAndroid: 该 类 与 控件 绘制 相关 ， 所 有 的 需 绘制 控件 都 必须 从 该 类 派 
Æ, Hif WebKit 模块 中 有 Button, Combo, Radio 三 类 控件 。 


上 述 类 会 在 Java 层 请 求 创 建 Web Frame 的 时 候 被 建立 。 


经 过 本 章 前 面 内 容 的 学 习 ， 相 信 大 家 已 经 基本 了 解 了 WebKit 系统 的 运作 原理 和 各 


6.3 WebKit 操作 


NI 


中 各 个 主要 类 的 功能 。 本 节 将 简单 介绍 和 WebKit 相关 的 基本 操作 知识 ， 为 读者 步 入 本 书 
后 面 知 识 的 学 习 打 下 基础 。 
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6.3.1 WebKit 初 始 化 


在 Android SDK 中 提供 了 WebView 类 ， 使 用 该 类 可 以 提供 客户 化 浏览 显示 功能 。 如 
果 客 户 需要 加 入 浏览 器 的 支持 ， 可 将 该 类 的 实例 或 者 派生 类 的 实例 作为 视图 ， 调 用 
Activity 类 的 setContentView 显示 给 用 户 。 当 客户 代码 中 第 一 次 生成 WebView 对 象 时 ， 会 
初始 化 WebKit 库 ( 包 括 Java 层 和 C 层 两 个 部 分 )， 之 后 用 户 可 以 操作 WebView 对 象 完成 网 
络 或 者 本 地 资源 的 访问 。 

WebView 对 象 的 生成 主要 涉及 3 个 类 : CallbackProxy 、 WebViewCore 以 及 
WebViewDatabase。 其 中 CallbackProxy 对 象 为 WebKit 模块 中 UI 线程 和 WebKit 类 库 提供 
交互 功能 ，WebViewCore 是 WebKit 的 核心 层 ， 负 责 与 C 层 交 互 以 及 WebKit 模块 C 层 类 
库 初 始 化 ， 而 WebViewDatabase 为 WebKit 模块 运行 时 缓存 、 数 据 存储 提供 支持 。 

初始 化 的 过 程 就 是 使 用 WebView 创建 CallbackProxy 对 象 和 WebViewCore 对 象 的 过 
程 。WebKit 模块 初始 化 流程 如 下 。 

(1) 调用 System.loadLibrary 载 入 WebCore 相关 类 库 (C 层 )。 

(2) 如 果 是 第 一 次 初始 化 WebViewCore 对 象 ， 创 建 WebCoreThread 线程 。 

(3) 创建 EventHub 对 象 ， 处 理 WebViewCore 事件 。 

(4) 获取 WebIconDatabase 对 象 实例 。 

(5) 向 WebCoreThread 发 送 初始 化 消息 。 

根据 上 述 流程 ， 假 如 我 们 要 获取 WebViewDatabase 实例 ， 则 可 以 按照 下 面 的 步骤 来 
实现 。 

(1) 调用 System.loadLibrary 方法 载 入 WebCore 相关 类 库 ， 该 过 程 由 Dalvik 虚拟 机 完 
成 ， 它 会 从 动态 链接 库 目录 中 寻找 libWebCore.so 类 库 ， 载 入 到 内 存 中 ， 并 且 调 用 WebKit 
初始 化 模块 的 JNI OnLoad 方法 。WebKit 模块 的 JINI OnLoad 方法 完成 以 下 初始 化 操作 。 

口 ”初始 化 FrameBridge[register android webcore framebridge]: 初始 化 gFrameAndroidField 

静态 变量 ， 以 及 注册 BrowserFrame 类 中 的 本 地 方法 表 。 

口 ” 初 始 化 JavaBridge[register android webcore javabridge]: 初始 化 gJavaBridge.mObject 

对 象 ， 以 及 注册 JWebCoreJavaBridge 类 中 的 本 地 方法 。 

Q ”初始 化 资源 Loader[register android webcore resource loader]: 初始 化 gResourceLoader 

静态 变量 ， 以 及 注册 LoadListener 类 的 本 地 方法 。 

Q ”初始 化 WebViewCore[register android webkit webviewcore]: 初始 化 gWebCoreViewImplField 

静态 变量 ， 以 及 注册 WebViewCore 类 的 本 地 方法 。 

O HURAE WebHistory[register android webkit webhistory]: 初始 化 gWebHistoryItem 

结构 ， 以 及 注册 WebBackForwardList 和 WebHistoryItem 类 的 本 地 方法 。 
口 ”初始 化 WebiconDatabase[register_android_webkit_webicondatabase]: 注册 WebIconDatabase 
类 的 本 地 方法 。 

口 “ 初 始 化 WebSettings[register android webkit websettings]: 初始 化 gFieldIds 静态 变 
量 ， 以 及 注册 WebSettings 类 的 本 地 方法 。 

口 “ 初 始 化 WebView[register android webkit webview]: 初始 化 gWebViewNativeField 
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静态 变量 ， 以 及 注册 WebView 类 的 本 地 方法 。 

(2) 实现 WebCoreThread 初始 化 ， 该 初始 化 只 在 第 一 次 创建 WebViewCore 对 象 时 完 
成 ， 当 用 户 代码 第 一 次 生成 WebView 对 象 ， 会 在 初始 化 WebViewCore 类 时 创建 
WebCoreThread 线程 ， 该 线程 负责 处 理 WebCore 初始 化 事件 。 此 时 WebViewCore 构造 函 
数 会 被 阻塞 ， 直 到 一 个 WebView 初始 化 请 求 完 毕 时 ， 会 在 WebCoreThread 线程 中 唤醒 。 

(3) 创建 EventHub 对 象 ， 该 对 象 处 理 WebView 类 的 事件 ， 当 WebCore 初始 化 完成 后 
会 向 WebView 对 象 发 送 事件 ，WebView 类 的 EventStub 对 象 处 理 该 事件 ， 并 且 完 成 后 续 
初始 化 工作 。 

(4) 获取 WebIconDatabase 对 象 实例 。 

(5) 向 WebViewCore 发 送 INITIALIZE 事件 ， 并 且 将 this 指针 作为 消息 内 容 传递 。 
WebView 类 主要 负责 处 理 UI 相关 的 事件 ， 而 WebViewCore 主要 负责 与 WebCore 库 交 
互 。 在 运行 时 期 ，UI 线程 和 WebCore 数据 处 理 线程 是 运行 在 两 个 独立 的 线程 当中 。 
WebCoreThread 线程 接收 到 INITIALIZE 事件 后 ， 会 调用 消息 对 象 参数 的 initialize 方法 ， 
而 后 唤醒 阻塞 的 WebViewCore Java 线程 (该 线程 在 WebViewCore 的 构造 函数 中 被 阻塞 )。 
不 同 的 WebView 对 象 实例 有 不 同 的 WebViewCore 对 象 实例 ， 因 此 通过 消息 的 方式 可 以 使 
得 UI 线程 和 WebViewCore 2 fif HA o WebCoreThread 的 事件 处 理 函数 ， 处 理 
INITIALIZE 消息 时 ， 调 用 的 是 不 同 WebView 中 WebViewCore 实例 的 initialize 方法 。 
WebViewCore 类 中 的 initialize 方法 中 会 创建 BrowserFrame 对 象 (该 对 象 管理 整个 Web fă 
体 ， 以 Frame 相关 事件 )， 并 且 向 WebView 对 象 发 送 WEBCORE INITIALIZED MSG ID 
消息 。WebView 消息 处 理 函数 能 够 根据 其 参数 来 初始 化 指定 WebViewCore 对 象 ， 并 且 能 
够 更 新 WebViewCore 的 Frame 缓冲 。 
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1. 载 入 网 络 数据 

在 代码 中 可 以 使 用 WebView 类 的 loadUrl 方法 ， 请 求 访问 指定 的 URL 网 页 数据 。 
WebView 对 象 中 保存 着 WebViewCore 的 引用 ， 由 于 WebView 属于 UI 线程 ， 而 
WebViewCore 属于 后 台 线 程 ， 因 此 WebView 对 象 的 loadUrl 被 调用 时 ， 会 通过 消息 的 方式 
将 URL 信息 传递 给 WebViewCore 对 象 ， 该 对 象 会 调用 成 员 变 量 mBrowserFrame 的 
loadUrl 方法 ， 进 而 调用 WebKit 库 完 成 数据 的 载 入 。 

在 载 入 网 络 数据 时 ， 此 功能 分 别 由 Java 层 和 C 层 共 同 完 成 ， 其 中 Java 层 负责 完成 用 
户 交 互 、 资 源 下 载 等 操作 ， 而 C 层 主要 完成 数据 分 析 ( 建 立 DOM 树 、 分 析 页 面 元 素 等 ) 操 
作 。 由 于 UI 线程 和 WebCore 线程 运行 在 不 同 的 两 个 线程 中 ， 因 此 当 用 户 请 求 访问 网 络 资 
源 时 ， 通 过 消息 的 方式 向 WebViewCore 对 象 发 送 载 入 资源 请 求 。 

在 Java 层 的 WebKit 模块 中 ， 所 有 与 资源 载 入 相关 的 操作 都 是 由 BrowserFrame 类 中 对 
应 的 方法 完成 ， 这 些 方法 是 本 地 方法 ， 会 直接 调用 WebCore 库 的 C 层 函 数 完 成 数据 载 入 
请 求 ， 以 及 资源 分 析 等 操作 。C 层 的 FrameLoader 类 是 浏览 框架 的 资源 载 入 器 ， 该 类 负责 
检查 访问 策略 以 及 向 Java 层 发 送 下 载 资源 请 求 等 功能 。 在 FrameLoader 中 ， 当 用 户 请 求 网 
络 资源 时 ， 经 过 一 系列 的 策略 检查 后 会 调用 FrameBridge 的 startLoadingResource 方法 ， 该 
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方法 会 回调 BrowserFrame(Java) 类 的 startLoadingResource 方法 ， 完 成 网 络 数据 的 下 载 ， 然 
后 类 BrowserFrame(Java) 的 方法 startLoadingResource 会 返回 一 个 LoadListener 的 对 象 ， 
FrameLoader 会 删除 原 有 的 FrameLoader 对 象 ， 将 LoadListener 对 象 封 装 成 
ResourceLoadHandler 对 象 ， 并 且 将 其 设置 为 新 的 FrameLoader。 到 此 完成 了 一 次 资源 访问 
请 求 ， 接 下 来 库 WebCore 会 根据 资源 数据 进行 分 析 和 构建 DOM， 以 及 构建 相关 的 数据 
结构 。 

2. 载 入 本 地 数据 

所 谓 本 地 数据 是 指 以 “data:/” 开 头 的 URL， 载 入 本 地 数据 的 过 程 和 载 入 网 络 数据 的 
方法 一 样 ， 只 不 过 在 执行 FrameLoader 类 的 executeLoad 方法 时 ， 会 根据 URL 的 SCHEME 
类 型 区 分 ， 调 用 DataLoader 的 requestUrl 方法 ， 而 不 是 调用 handleHTTPLoad 建立 实际 的 
网 络 通信 连接 。 

3. 载 入 文件 数据 

所 谓 文 件数 据 是 指 以 “file/” 开 头 的 URL， 载 入 文件 数据 的 基本 流程 与 网 络 数据 载 入 
流程 基本 一 致 ， 不 同 的 是 在 运行 FrameLoader 类 的 executeLoad 方法 时 ， 根 据 SCHEME 类 
型 ， 调 用 FileLoader 的 requestUrl 方法 来 完成 数据 加 载 。 


6.3.3 ”刷新 绘制 


当 用 户 拖 动 滚动 条 、 有 窗口 遮盖 或 者 有 页 面 事件 触发 时 都 会 向 WebViewCore(Java Jz) 
对 象 发 送 背 景 重 绘 消 息 ， 该 消息 会 引起 网 页 数据 的 绘制 操作 。WebKit 的 数据 绘制 可 能 出 于 
效率 上 的 考虑 ， 没 有 通过 Java 层 ， 而 是 直接 在 C 层 使 用 SGL 库 完 成 。 与 Java 层 图 形 绘制 
相关 的 Java 对 象 有 3 个 ， 有 具体 说 明 如 下 。 
Q Picture 类 : 该 类 对 SGL 封装 ， 其 中 变量 mNativePicture 实际 上 是 保存 着 SkPicture 
对 象 的 指针 。WebViewCore 中 定义 了 两 个 Picture 对 象 ， 当 作 双 缓冲 处 理 ， 在 调 
用 webKitDraw 方法 时 ， 会 交换 两 个 缓冲 区 ， 加 速 刷 新 速度 。 
Q WebView 类 : 该 类 接受 用 户 交互 相关 的 操作 ， 当 有 滚屏 、 窗 口 遮盖 、 用 户 点 击 页 
面 按钮 等 相关 操作 时 ，WebView 对 象 会 与 之 相关 的 WebViewCore 对 象 发 送 
VIEW SIZE CHANGED 消息 。 当 WebViewCore 对 象 接收 到 该 消息 后 ， 将 构建 时 
建立 的 mContentPictureB 刷新 到 屏幕 上 ， 然 后 将 mContentPictureA 与 之 交换 。 
Q  WebViewCore 类 : 该 类 封装 了 WebKit C 层 代码 ， 为 视图 类 提供 对 WebKit 的 操 
作 接 口 ， 所 有 对 WebKit 库 的 用 户 请 求 均 由 该 类 处 理 ， 并 且 该 类 还 为 视图 类 提供 
了 两 个 Picture 对 象 ， 用 于 图 形 数据 刷新 。 
例如 我 们 在 拖 电 Web 页 面 ， 当 用 户 使 用 手指 点 击 触摸 屏 并 且 移动 手指 时 会 引发 touch 
事件 ，Android 平台 会 将 touch 事件 传递 给 最 前 端的 视图 响应 (dispatchTouchEvent 方法 处 
H). Æ WebView 类 中 定义 了 5 种 touch 模式 ， 在 手指 拖 动 Web 页 面 的 情况 下 ， 会 触发 
mMotionDragMode， 并 且 会 调用 View 类 的 scrollBy 方法 ， 触 发 滚屏 事件 以 及 使 视图 无 效 
( 重 绘 ， 会 调用 View 的 onDraw 方法 )。WebView 视图 中 的 滚屏 事件 由 onScrollChanged 方 
法 响应 ， 该 方法 向 WebViewCore 对 象 发 送 SET VISIBLE RECT 事件 。 


» Andioid sssapvnsma 


WebViewCore 对 象 接收 到 SET VISIBLE RECT 事件 后 ， 将 消息 参数 中 保存 的 新 视图 
的 矩形 区 域 大 小 传递 给 nativeSetVisibleRect 方法 ， 通 知 WebCoreViewImpl 对 象 (C 层 ) 视 图 
矩形 变更 (WebCoreViewImpl::setVisibleRect 方法 )。 在 setVisibleRect 方法 中 ， 会 通过 虚拟 
机 调用 WebViewCore 的 contentInvalidate 方法 ， 该 方法 会 引发 webkitDraw 方法 的 调用 ( 通 
过 WEBKIT DRAW 消息 )。 在 方法 webkitDraw 中 ， 首 先 会 将 mContentPictureB 对 象 传递 
给 本 地 方法 nativeDraw 绘制 ， 然 后 将 mContentPictureB 的 内 容 与 mContentPictureA 的 内 容 
互 换 。 在 这 里 mContentPictureA 缓冲 区 是 供给 WebViewCore 的 draw 方法 使 用 ， 如 果 用 户 
选择 某 个 控件 ， 绘 制 焦点 框 时 WebViewCore 对 象 的 draw 方法 会 被 调用 ， 绘 制 的 内 容 保存 
在 mContentPictureA 中 ， 之 后 会 通过 Canvas 对 象 (Java 层 ) 的 drawPicture 方法 将 其 绘制 到 
屏幕 上 ， 而 mContentPictureB 绥 冲 区 是 用 于 built 操作 的 ，nativeDraw 方法 中 首先 会 将 传递 
的 mContentPictureB 对 象 数据 重 置 ， 而 后 在 重新 构建 的 mContentPictureB 画布 上 ， 将 层 上 
相关 的 元 素 绘制 到 该 画布 上 ， 然 后 将 mContentPictureB 和 mContentPictureA 的 内 容 互 换 ， 
这 样 一 次 重 绘 事件 产生 时 (会 调用 WebView.onDraw 方法 ) 会 将 mContentPictureA 的 数据 使 
用 Canvas 类 的 drawPicture 绘制 到 屏幕 上 。 当 webkitDraw 方法 将 mContentPictureA 与 
mContentPictureB 指针 对 调 后 ， 会 向 WebView 对 象 发 送 NEW_PICTURE MSG ID 消息 ， 
该 消息 会 引发 WebViewCore 的 VIEW SIZE CHANGED 消息 的 产生 ， 并 且 会 使 当前 视图 无 
效 ， 产 生 重 绘 事件 (invalidate0)， 引 发 onDraw 方法 的 调用 ， 完 成 一 次 网 页 数据 的 绘制 过 程 。 


6.4 WebView 类 详解 


在 本 章 前 面 的 内 容 中 曾经 提 到 过 ，WebView 是 一 个 非常 重要 的 类 ， 能 够 实现 和 网 络 有 
关 的 很 多 功能 。WebView 能 加 载 显示 网 页 ， 可 以 将 其 视 为 一 个 浏览 器 ， 使 用 WebKit 演 染 
引擎 来 加 载 显示 网 页 。 在 本 节 的 内 容 中 ， 将 详细 讲解 WebView 的 基本 知识 。 


6.4.1 WebView 概 述 


通过 WebView 可 以 滚动 Web 浏览 器 或 简单 地 显示 您 在 网 上 活动 的 某 些 内 容 。 
WebView 采用 WebKit 演 染 引擎 来 显示 网 页 的 方法 ， 包 括 向 前 和 向 后 导航 的 历史 、 放 大 和 
缩小 、 执 行文 本 搜索 和 是 否 启用 内 置 的 变焦 。 
WebView 中 的 主要 方法 如 下 。 
Q  addJavascriptInterface(Object obj. StringinterfaceName): 使 用 此 函数 来 绑 定 一 个 对 
象 的 JavaScript， 该 方法 可 以 访问 JavaScript。 
OQ  loadData(String data, String mimeType, Stringencoding): 此 方法 经 常 出 现 乱 码 ， 尽 
量 少 用 。 
口 loadDataWithBaseURL(String baseUrl, String data, String mimeType.String encoding, 
StringhistoryUrl): 加 载 到 WebView 给 定 的 数据 ， 以 此 为 基础 内 容 的 网 址 提供 的 
网 址 。 
Q capturePicture(): 捕捉 当前 WebView 的 图 片 。 
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clearCache(boolean includeDiskFiles): 清除 资源 的 缓存 。 
destroyO: 销毁 此 WebView。 
setDefaultFontSize(): 设置 字体 。 
setDefaultZoom(): 设置 屏幕 的 缩放 级 别 。 
Android 的 所 有 控件 中 ，WebView 的 功能 最 强大 ， 它 作为 直接 从 
android.webkit.Webview 实现 的 类 ， 可 以 拥有 浏览 器 所 有 的 功能 ，WebView 可 以 让 开发 人 
员 从 Java 转向 “HTML+JS” 这 样 的 方式 。 如 果 具 备 了 Ajax 技术 ， 就 可 以 方便 通过 这 种 方 
式 配合 远 端 Server 来 实现 一 些 内 容 。 

从 Android 2.2 中 开始 加 入 了 Adobe Flash Player 功能 ， 我 们 可 以 通过 如 下 代码 设置 允 
VF Gears 插件 来 实现 网 页 中 的 Flash 动画 显示 。 

WebView.getSettings () .setPluginsEnabled (true); 

通过 使 用 WebView， 可 以 帮助 我 们 设计 内 岩 专 业 的 浏览 器 ， 相 对 于 部 分 以 省 流量 需要 
服务 器 中 转 的 那 种 HTML 解析 器 来 说 有 本 质 的 区 别 ， 因 为 它们 没有 JavaScript 脚本 解析 
器 ， 所 以 不 会 有 什么 太 大 的 发 展 空间 。 

1. 访问 网 页 

通过 loadUrl0 方 法 可 以 访问 网 页 ， 例 如 下 面 的 代码 : 


wb= (WebView)findViewById (R.id.wb); 
wb.loadUrl (url); 


BDDDO 


2. 设置 属性 

对 于 浏览 器 的 设置 ， 可 以 通过 WebSettings 来 设置 WebView 的 一 些 属性 和 状态 等 ， 例 
如 下 面 的 代码 : 

WebSettingswebSettings-mWebView.getSettings(); 

webSettings.setJavaScriptEnabled (true); 

// 设 置 可 以 访问 文件 

webSettings.setAllowFileAccess (true); 


// 设 置 支持 缩放 


webSettings.setBuiltInZoomControls (true); 


3. WebViewClient#aWebChromeClient 


WebViewClient 和 WebChromeClient 可 以 看 作 是 辅助 WebView 管理 网 页 中 各 种 通知 、 
请 求 等 事件 以 及 JavaScript 时 间 的 两 个 类 。 

1) WebViewClient 

利用 WebView 的 setWebViewClient() 方 法 可 以 指定 一 个 WebViewClient XJ $$, 3816 
盖 该 类 的 方法 来 辅助 WebView 浏览 网 页 。 例 如 下 面 的 代码 : 

mWebView.setWebViewClient (newWebViewClient () 


{ 
publicbooleanshouldOverrideUrlLoading (WebViewview, Stringurl) 


{ 
view. loadUrl (url); 
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returntrue; 

} 

@override 

publicvoidonPageFinished (WebViewview,Stringurl) 
t 

super.onPageFinished (view, url); 

) 

GOverride 

publicvoidonPageStarted (WebViewview,Stringurl,Bitmapfavicon) 
t 

super.onPageStarted (view, url, favicon) ; 

} 

p; 


2) WebChromeClient 
对 于 网 页 中 使 用 的 JavaScript 脚本 语言 ， 便 可 以 使 用 WebChromeClient 类 处 理 JS 事 
件 ， 如 对 话 框 加 载 进度 等 ， 例 如 下 面 的 代码 : 
mWebView.setWebChromeClient (newWebChromeClient () ( 
@override 
// 处 理 JavaScript 中 的 alert 


publicbooleanonJsAlert (WebViewview,Stringurl,Stringmessage, 
finalJsResultresult) 


t 

// 构 建 一 个 Builder 来 显示 网 页 中 的 对 话 框 
Builderbuilder=newBuilder (Activitythis); 
builder.setTitle ("提示 对 话 框 ") ; 
builder.setMessage (message); 
builder.setPositiveButton (android.R.string.ok, 
newAlertDialog.OnClickListener () { 
publicvoidonClick (DialogInterfacedialog, intwhich) { 
// 单 击 “ 人 确定 ”按钮 之 后 ， 继 续 执行 网 页 中 的 操作 
result.confirm(); 

} 

); 

builder.setCancelable (false); 
builder.create(); 

builder.show(); 

returntrue; 

Ez 


6.4. ”实现 WebView 的 两 种 方式 

WebView 能 够 以 加 载 的 方式 显示 网 页 ， 可 以 将 其 视 为 一 个 浏览 器 。WebView 使 用 
WebKit 泻 染 引擎 加 载 显 示 网 页 。 在 开发 应 用 中 有 以 下 两 种 实现 WebView 的 方法 。 

1. 第 一 种 实现 方法 

(1) 在 Activity 中 实例 化 WebView 组 件 。 
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WebView webView = new WebView (this); 


(2) 调用 WebView 的 loadUrl(0 方 法 ， 设 置 WebView 要 显示 的 网 页 。 
口 ” 如 果 显 示 互 联网 则 使 用 : 


webView.loadUrl ("http://www.google.com"); 


Q ”如 果 显 示 本 地 文件 则 使 用 : 

webView.loadUrl("file:///android asset/Xx.html");// 本 地 文件 存放 在 “assets” 

文件 中 

(3) 调用 Activity 的 setContentView() 方 法 来 显示 网 页 视图 。 

(4) 用 WebView 点 链接 看 了 很 多 页 以 后 为 了 让 WebView 支持 回 退 功能 ， 需 要 覆盖 
Activity 类 的 onKeyDown() 方 法 ， 如 果 不 做 任何 处 理 ， 点 击 系统 回 退 键 ， 整 个 浏览 器 会 调 
用 finish() 而 结束 自身 ， 而 不 是 回 退 到 上 一 页 面 。 

(5) 在 AndroidManifest xml 文件 中 添加 权限 ， 否 则 会 出 现 “Web page not available” 
错误 。 


<uses-permission android:name="android.permission.INTERNET" /> 


接 下 来 我 们 看 一 个 使 用 上 述 方法 的 演示 代码 。 
首先 编写 程序 文件 MainActivity.java， 具 体 代码 如 下 : 


package com.android.webview.activity; 


import android.app.Activity; 
import android.os.Bundle; 
import android.view.KeyEvent; 
import android.webkit.WebView; 


public class MainActivity extends Activity ( 

private WebView webview; 

GOverride 

public void onCreate (Bundle savedInstanceState) { 
super .onCreate (savedInstanceState); 
// 实 例 化 WebView 对 象 
webview = new WebView (this); 
// 设 置 WebView 属性 ， 能 够 执行 Javascript 脚本 
webview.getSettings () .setJavaScriptEnabled (true); 
// 加 载 需要 显示 的 网 页 
webview.loadUrl ("http://www.51cto.com/") ; 
// 设 置 web 视图 
setContentView (webview); 

} 


@Override 
// 设 置 回 退 
// 覆 盖 Activity 类 的 onKeyDown (int keyCoder,KeyEvent event) 方 法 
public boolean onKeyDown(int keyCode, KeyEvent event) { 
if ((keyCode == KeyEvent.KEYCODE BACK) && webview.canGoBack()) ( 
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webview.goBack(); //goBack() 表 示 返 回 webview 的 上 一 页 面 
return true; 


b 
return false; 


} 
然后 在 文件 AndroidManifest.xml 中 添加 如 下 INTERNET BUE: 


«uses-permission android:name-"android.permission.INTERNET"/» 


2. 第 二 种 实现 方式 


(1) 在 布局 文件 中 声明 WebView。 

(2) 在 Activity 中 实例 化 WebView。 

(3) 调用 WebView 的 loadUrl( ) 方 法 ， 设 置 WebView 要 显示 的 网 页 。 

(4) 为 了 让 WebView 能 够 响应 超 链接 功能 ， 调 用 setWebViewClient0 方 法 ， 设 置 
WebView 视图 

(5) 用 WebView 点 链接 看 了 很 多 页 以 后 为 了 让 WebView 支持 回 退 功能 ， 需 要 覆盖 
Activity 类 的 onKeyDown() 方 法 ， 如 果 不 做 任何 处 理 ， 点 击 系统 回 退 键 ， 整 个 浏览 器 会 调 
用 finish0 而 结束 自身 ， 而 不 是 回 退 到 上 一 页 面 。 

(6) 在 文件 AndroidManifest.xml 中 添加 如 下 权限 ， 否 则 出 现 “Web page not available" 


错误 。 
<uses-permission android:name="android.permission.INTERNET"/> 


接 下 来 我 们 看 一 个 使 用 上 述 方法 的 演示 代码 。 
首先 编写 程序 文件 MainActivity.java， 具 体 代 码 如 下 : 


package com.android.webview.activity; 


import android.app.Activity; 

import android.os.Bundle; 

import android.view.KeyEvent; 

import android.webkit.WebView; 
import android.webkit.WebViewClient; 


public class MainActivity extends Activity ( 

private WebView webview; 

@override 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView(R.layout.main); 
webview = (WebView) findViewById(R.id.webview) ; 
// AH WebView 属性 ， 能 够 执行 Javascript 脚本 
webview.getSettings () .setJavaScriptEnabled (true); 
// 加 载 需要 显示 的 网 页 
webview.loadUrl ("http://www.5lcto.com/"); 
// 设 置 Web 视图 


webview.setWebViewClient (new HelloWebViewClient ()); 
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@override 
// 设 置 回 退 
// 覆 盖 Activity 类 的 onKeyDown (int keyCoder,KeyEvent event) 方 法 
public boolean onKeyDown (int keyCode, KeyEvent event) { 
if ((keyCode == KeyEvent.KEYCODE BACK) && webview.canGoBack()) { 
webview.goBack(); //goBack() 表 示 返 回 webvi ew 的 上 一 页 面 
return true; 
} 
return false; 
H 


/ /Web 视图 
private class HelloWebViewClient extends WebViewClient ( 
@override 
public boolean shouldOverrideUrlLoading (WebView view, String url) { 
view. loadUrl (url); 
return true; 


} 
然后 编写 布局 文件 main.xml， 主 要 代码 如 下 : 


«?xml version-"1.0" encoding="utf-8"?> 

<LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:orientation-"vertical" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 


> 
<WebView 
android: id="@+id/webview" 
android:layout width="fill parent" 
android:layout height="fill parent" 
/> 
</LinearLayout> 


最 后 在 文件 AndroidManifest.xml 中 添加 INTERNET 权限 ， 代 码 如 下 


<uses-permission android:name-"android.permission.INTERNET"/» 


6.4.8 ”WebView 的 常见 功能 


WebView 有 以 下 几 个 常见 功能 。 

(1) 背景 设置 。 例 如 下 面 的 代码 : 

WebView.setBackgroundColor (0) ;// 先 设置 背景 色 为 transparent 
WebView.setBackgroundResource (R.drawable.-yourImage) ;// 然 后 设置 背景 图 片 


(2) 获得 WebView 网 页 加 载 初始 化 和 完成 事件 。 基 本 步骤 如 下 。 
© 创建 一 个 自己 的 、 继 承 于 WebViewClient 类 的 WebViewClient， 例 如 
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WebViewClient. 
@ AX onPageFinished() A i (WebView 加 载 完成 会 调用 这 个 方法 )。 
© 通过 方法 webView.setWebViewClient(0) 关 联 WebViewClient 与 WebView. 
例如 下 面 的 代码 : 
mWebView.setWebViewClient (new WebViewClient() 
t 


@override 
public void onPageFinished(WebView view, String url) 


{ 
// 结 束 
super.onPageFinished(view, url); 
) 
GOverride 
public void onPageStarted(WebView view, String url, Bitmap favicon) 


t 
// 开 始 
super.onPageStarted(view, url, favicon); 
) 
he 


如 果 需 要 监视 加 载 进度 ， 则 需要 创建 一 个 WebChromeClient 2$, Jf HE 477 iX 
onProgressChanged ， 再 进行 webview.setWebChromeClient(new MyWebChromeClient()) 即 
可 。 例 如 下 面 的 代码 ; 


class MyWebChromeClient extends WebChromeClient ( 
@override 
public void onProgressChanged (WebView view, int newProgress) { 
// TODO Auto-generated method stub 
super.onProgressChanged (view, newProgress) ; 
} 
$ 
public class WebPageLoader extends Activity { 
final Activity activity = this; 


@override 
public void onCreate (Bundle savedInstanceState) { 
super .onCreate (savedInstanceState); 
this .getWindow() .requestFeature (Window. FEATURE PROGRESS); 
setContentView (R. layout.main) ; 
WebView webView = (WebView) findViewById(R.id.webView) ; 
webView.getSettings().setJavaScriptEnabled (true); 
webView.getSettings ().setSupportZoom(true); 
webView.setWebChromeClient (new WebChromeClient() ( 
public void onProgressChanged(WebView view, int progress) ( 
activity.setTitle("Loading..."); 
activity.setProgress (progress * 100); 
if (progress == 100) 
activity.setTitle(R.string.app name); 
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) 
p; 
webView.setWebViewClient (new WebViewClient() ( 
public void onReceivedError(WebView view, int errorCode, 
String description, String failingUrl) ( // Handle the error 
} 


public boolean shouldOverrideUrlLoading (WebView view, String url) ( 
view.loadUrl (url); 
return true; 
if 
n; 
webView.loadUrl ("http://www.sohu.com") ; 


} 

(3) 使 用 WebView 阅读 PDF 文件 。 

Android 本 身 不 支持 打开 PDF 文件 ， 其 实 Google 提供 了 在 线 解析 PDF 的 方法 ， 即 使 
用 WebView 来 实现 。 例 如 下 面 的 代码 : 

WebView webview = (WebView) findViewById(R.id.wv); 

webview.getSettings () .setJavaScriptEnabled (true); 

String pdf ="http://www.***** pdf"; 

webview.loadUrl("http://docs.google.com/gview?embedded-true&url-" + pdf); 

(4) 当 用 Web View 加 载 网 页 时 在 标题 栏 上 显示 加 载 进度 。 

这 个 功能 很 容易 理解 ， 如 图 6-3 所 示 。 当 在 使 用 WebView 加 载 网 页 时 ， 可 以 在 标题 栏 
显示 加 载 进度 ， 这 样 做 的 目的 是 更 加 友好 地 提示 用 户 。 


si 
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6-3 ”加 载 网 页 
例如 下 面 的 代码 : 


public class ProgressTest extends Activity( 
final Activity context - this; 


GOverride 
public void onCreate (Bundle b) ( 
super.onCreate (b) ; 
requestWindowFeature (Window.FEATURE PROGRESS) ;// 让 进度 条 显示 在 标题 栏 上 
setContentView(R.layout.main); 
WebView webview = (WebView)findViewById (R.id.webview); 
webview.setWebChromeClient (new WebChromeClient() ( 
public void onProgressChanged(WebView view, int progress) { 
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/ /Activity Wl webview 根据 加 载 程度 决定 进度 条 的 进度 大 小 
// 当 加 载 到 100% 的 时 候 进 度 条 自动 消失 


context.setProgress(progress * 100); 


} 
); 
webview.loadUrl (url); 
) 


其 实 上 述 功能 在 Android 开发 中 十 分 常见 ， 当 前 主流 的 开发 模式 是 
“WebView+ProgressDialog”。 再 看 下 面 演示 代码 的 实现 过 程 。 
首先 编写 一 个 名 为 webview.xml 的 布局 文件 ， 代 码 如 下 : 


<LinearLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation-"vertical" 
android:layout width-"fill parent" 
android:layout height-"fill parent"> 
<WebView android:id-"(*id/webview" 
android:layout width-"fill parent" 
android:layout height-"fill parent"/» 
</LinearLayout> 


然后 编写 一 个 名 为 WebViewActivity.java 的 工程 文件 ， 主 要 代码 如 下 : 


public class WebViewActivity extends Activity( 
private WebView webView; 


private AlertDialog alertDialog; 

private ProgressDialog progressBar; 

//jQuery datatables 使 用 

@override 

protected void onCreate(Bundle savedInstanceState) { 
super .onCreate (savedInstanceState) ; 
setContentView (R. layout .webview) ; 
// 加 载 webview 
initWebView(); 


GOverride 
public boolean onKeyDown(int keyCode, KeyEvent event) ( 
if(keyCode == KeyEvent.KEYCODE BACK && webView.canGoBack())í 
webView.goBack(); 
return true; 
b 
return super.onKeyDown(keyCode, event); 
5 
class MyWebViewClient extends WebViewClient( 
@override 
public boolean shouldOverrideUrlLoading (WebView view, String url) 


view. loadUrl (url); 
return true; 
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@override 
public void onPageFinished(WebView view, String url) { 
if (progressBar.isShowing()) { 
progressBar.dismiss(); 


@override 
public void onReceivedError (WebView view, int errorCode, 
String description, String failingUrl) { 
Toast.makeText (WebViewActivity.this, "网 页 加 载 出 错 !"， 
Toast.LENGTH LONG); 


alertDialog.setTitle ("ERROR"); 
alertDialog.setMessage (description); 
alertDialog.setButton("OK", new 
DialogInterface.OnClickListener () { 
@override 
public void onClick(DialogInterface dialog, int which) { 
// TODO Auto-generated method stub 
) 
he 
alertDialog.show(); 


protected void initWebView() { 
// 设 计 进 度 条 
progressBar = ProgressDialog.show(WebViewActivity.this, null, 
"正在 进入 网 页 ， 请 稍 后 …") ; 
// 获 得 webView 组 件 
webView = (WebView) this.findViewById (R.id.webview); 


webView.getSettings() .setJavaScriptEnabled (true); 
webView.loadUrl ("http://www.baidu.com") ; 
alertDialog = new AlertDialog.Builder (this) .create(); 


// 设 置 视 图 客户 端 
webView.setWebViewClient (new MyWebViewClient ()); 


j 


最 后 ， 在 文件 AndroidManifest.xml 中 添加 访问 互联 网 的 权限 ， 否 则 不 能 显示 。 代 码 
如 下 : 


«uses-permission android:name-"android.permission.INTERNET"/» 
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上 述 过 程 就 是 基于 “WebView+ProgressDialog” 开 发 模式 的 过 程 。 
(5) 使 用 WebView 调用 拨号 键盘 。 例 如 下 面 的 代码 : 


wv.setWebViewClient (new WebViewClient () { 
public boolean shouldOverrideUrlLoading (WebView view,String url) { 
// 当 有 新 连接 时 ， 使 用 当前 的 webview 
view.loadUrl (url); 
// 调 用 拨号 程序 
if (url.startsWith("mailto:") || url.startsWith("geo:") 
||url.startsWith("tel:")) { 
Intent intent = new Intent (Intent.ACTION VIEW, 
Uri.parse(url)); 
startActivity (intent) ; 
} 
return true; 


} 
}); 
(6) 拦截 超 链接 。 
可 以 使 用 WebView 拦截 超 链接 ， 用 URL 表示 拦截 到 的 链接 ， 我 们 可 以 对 URL 做 判 
断 ， 比 如 在 线 播 放 音 乐 的 链接 ， 即 检测 其 中 是 否 含有 http:/xxx.mp3 这 种 链接 ， 如 果 有 就 调 
音乐 播放 器 来 播放 ， 或 者 是 在 线 播放 “rtsp://” 格 式 的 。 例 如 下 面 的 代码 : 


mWebView.setWebViewClient (new WebView Client()( 


y * 
此 处 能 拦截 超 链接 的 URL, BIAR href 请求 的 内 容 
ky 


public boolean shouldOverrideUrlLoading(WebView view, String url) { 
view.loadUrl (url); 
return true; 
} 
); 
(7) 处 理 SslError. 
在 Android 中 ，WebView 是 用 来 加 载 HTTP 和 HTTPS 网 页 到 本 地 应 用 的 控件 。 在 默 
认 情 况 下 ， 通 过 loadUrl(String ur) 方 法 ， 可 以 顺利 加 载 诸如 http:/www.baidu.com 之 类 的 页 
面 。 但 是 ， 当 加 载 有 SSL 层 的 HTTPS 页 面 (例如 https:/money.183.com.cn/) 时 ， 如 果 这 个 网 
站 的 安全 证 书 在 Android 无 法 得 到 认证 ，WebView 就 会 变 成 一 个 空白 页 ， 而 并 不 会 像 PC 
浏览 器 中 那样 跳出 一 个 风险 提示 框 。 因 此 ， 我 们 必须 针对 这 种 情况 进行 处 理 。 在 Android 
处 理 时 需要 用 到 以 下 两 个 类 。 
ū import android.NET.http.SslError 
ū import android.webkit.SslErrorHandler 
具体 的 用 法 如 下 : 
WebView wv = (WebView) findViewById(R.id.webview); 
wv.setWebViewClient (new WebViewClient () { 


public void onReceivedSslError(WebView view, SslErrorHandler handler, 
SslError error) { 
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//handler.cancel(); 默认 的 处 理 方式 ，WebView 变 成 空白 页 
/ /handler.process () ;接收 证 书 
//handleMessage (Message msg); 其 他 处 理 


} 


(8) 删除 缓存 。 
可 以 使 用 WebView 删除 手机 上 的 缓存 。 例 如 下 面 的 代码 : 


private int clearCacheFolder (File dir, long numDays) { 
int deletedFiles = 0; 
if (dir!= null && dir.isDirectory()) ( 
try ( 
for (File child:dir.listFiles()) ( 
if (child.isDirectory()) { 
deletedFiles += clearCacheFolder(child, numDays); 
) 
if (child.lastModified() « numDays) ( 
if (child.delete()) ( 
deletedFiles++; 
) 
) 
) 
) catch(Exception e) ( 
e.printStackTrace(); 
) 


) 
return deletedFiles; 


) 

优先 使 用 缓存 的 设置 代码 如 下 : 

WebView.getSettings () .setCacheMode (WebSettings.LOAD CACHE ELSE NETWORK); 

使 用 缓存 的 设置 代码 如 下 。 

WebView.getSettings().setCacheMode (WebSettings.LOAD NO CACHE); 

(9) 使 用 WebView 设置 URL 的 加 载 。 

当 在 WebView 里 打开 一 个 链接 时 ， 默 认 会 通过 ActivityManager 寻找 合适 的 浏览 器 进 
行 打开 ， 如 果 想 避免 这 种 事情 的 发 生 的 话 ， 可 以 通过 如 下 流程 解决 。 


© 添加 权限 。 
在 文件 AndroidManifestxml 中 声明 android.permission.INTERNET 权限 ， 否 则 会 出 现 


“Web page not available” 错 误 。 
@) 在 要 显示 的 Activity 中 生成 一 个 WebView 组 件 : 


WebView webView = new WebView (this); 


设置 WebView 基本 信息 : 
如 果 访 问 的 页 面 中 有 JavaScript， 则 WebWiew 必须 设置 支持 JavaScript。 


webview.getSettings () .setJavaScriptEnabled (true); 
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还 需要 设置 触摸 焦点 起 作用 : 
requestFocus(); 
MRA HE: 
this.setScrollBarStyle (SCROLLBARS OUTSIDE OVERLAY) ; 


@ 设置 WevView 要 显示 的 网 页 。 


口 ”互联 网 用 : 
webView.loadUrl ("http://www.google.com"); 
o ”本 地 文件 用 : 


webView.loadUrl("file:///android asset/XX.html"); 

其 中 本 地 文件 存放 在 assets 目录 中 。 

®© WRH WebView 点 击 链接 看 了 很 多 网 页 以 后 ， 如 果 不 做 任何 处 理 ， 点 击 系统 的 
Back 键 ， 整 个 浏览 器 会 调用 finishO 而 结束 自身 ， 如 果 和 希望 浏览 的 网 页 回 退 而 不 是 退出 浏 
览 器 ， 需 要 在 当前 Activity 中 处 理 并 消费 掉 该 Back 事件 ， 并 覆盖 Activity 类 的 
onKeyDown(int keyCoder,KeyEvent event) 方 法 。 

根据 上 述 做 法 可 知 ， 其 实 就 是 实现 了 一 个 继承 于 WebViewClient 的 类 ， 例 如 下 面 的 
代码 : 


public class TestClient extends WebViewClient { 


public boolean shouldOverrideUrlLoading (WebView webview, String url) { 
Log.d("TestClient", url); 
//ToDO: 在 此 添加 URL 处 理 代码 ， 如 果 返 回 true， 则 Webview 不 会 请 求 AcitvityManager 
打开 这 个 URL 


return false; 


) 


从 此 以 后 ， 就 可 以 通过 WebView.setWebViewClient0 设 置 上 述 类 的 实例 化 对 象 即 可 ， 
这 也 可 以 算是 一 种 另类 的 HTML 页 面 与 Java 之 间 的 通信 手段 ， 甚 至 可 以 用 在 浏览 器 插件 
和 Java 程序 之 间 的 通信 。 


6.4.4 ”使 用 WebView 类 浏览 网 页 


实 例 功 能 源码 路 径 


在 手机 屏幕 中 浏览 网 页 


在 本 实例 中 用 到 了 Android 系统 中 的 内 置 WebKit 引擎 ， 通 过 此 引擎 中 的 WebView 类 
来 浏览 网 页 。 在 具体 实现 时 ， 是 通过 WebView.loadUrl 来 加 载 网 址 的 。 当 从 EditText 中 传 


入 要 浏览 的 网 址 后 ， 可 以 在 WebView 中 加 载 网 页 的 内 容 。 本 实例 的 具体 实现 流程 如 下 。 
(1) 编写 布局 文件 main xml， 在 里 面 插入 一 个 WebView 控件 。 主 要 代码 如 下 : 
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<!-- 建立 一 个 TextView --> 
<TextView 
android: id="@+id/myTextViewl" 
android:layout width="fill parent" 
android: layout_height="wrap content" 
android: text="@string/hello" 


/> 
<!-- 建立 一 个 EditText --> 
«EditText 


android: id="@+id/myEditText1” 
android:layout width="267px" 
android:layout height="40px" 
android: textSize="18sp" 
android:layout x="5px" 


android:layout y="32px" 

/> 

<!-- 建立 一 个 ImageButton --> 
<ImageButton 


android: id="@+id/myImageButton1" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android: background="@drawable/white" 
android: src="@drawable/go" 
android:layout x="275px" 
android:layout y="35px" 


/> 
<!-- 建立 一 个 WebView --» 
<WebView 


android: id="@+id/myWebView1" 
android: layout height="330px" 
android:layout width="300px" 
android:layout x="7px" 
android:layout y="90px" 

android: background="@drawable/black" 
android: focusable="false" 

/> 


(2) 编写 文件 wang. java, iit setOnClickListener 监听 按钮 单 击 事件 ， 单 击 网 址 后 面 的 
箭头 后 会 抓 取 EditText 中 的 数据 ， 然 后 打开 此 网 址 ， 并 在 WebView 中 显示 网 页 内 容 。 具 
体 代码 如 下 : 


package irdc.wang; 


import irdc.wang.R; 

import android.app.Activity; 
import android.os.Bundle; 

import android.view.KeyEvent; 
import android.view.View; 

import android.webkit.WebView; 
import android.widget.EditText; 
import android.widget.ImageButton; 
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import android.widget.Toast; 


public void onCreate (Bundle savedInstanceState) 

t 
super.onCreate (savedInstanceState); 
setContentView (R.layout.main); 
mImageButtonl = (ImageButton) findViewById (R.id.myImageButtonl); 
mEditTextl = (EditText)findViewById(R.id.myEditText1l); 
mWebViewl = (WebView) findViewById (R.id.myWebViewl); 


/* 当 单 击 箭头 后 */ 
mImageButtonl.setOnClickListener (new 
ImageButton.OnClickListener() 
t 
@override 
public void onClick(View arg0) 
{ 
// TODO Auto-generated method stub 
{ 
mImageButtonl.setImageResource (R.drawable.go 2); 
/* MU EditText 中 的 数据 */ 
String strURI = (mEditTextl.getText().toString()); 
/* WebView 显示 网 页 内 容 */ 
mWebViewl.loadUrl (strURI) ; 
Toast.makeText ( 
example2.this, getString(R.string.load)+strURI, 
Toast.LENGTH LONG) 
-Show(); 


H); 


执行 后 显示 一 个 文本 框 ， 在 此 可 以 输入 网 址 ， 如 图 6-4 所 示 。 输 入 网 址 并 单 击 后 面 的 
?按钮 后 ， 将 显示 此 网 页 的 内 容 ， 如 图 6-5 所 示 。 


[S)http://3g.163.com/x/ a 
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新 闻 wE 军事 ”娱乐 | 游戏 
邮箱 博客 股票 ”下载 NBA 
读书 女人 | 汽车 XA | 微 博 


e 彩票 .团购 
* UC 浏览 器 7.8 新 版 就 是 比 你 快 
， 野田 佳 彦 当选 日 本 民主 党 党 首 
+ 南京 婚前 房产 "加 名 税 "7 天 3 变 
+ [ 投 ] 机 场 安检 升级 有 无 必要 ? 


图 6-4 输入 网 址 图 6-5 打开 的 网 页 
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6.4.5 ”使 用 WebView 类 加 载 HTML 程 序 


实例 | 功 能 源码 路 径 
实例 6-2 | 在 手机 屏幕 中 加 载 HTML 程序 下 载 路 径 :vdaimaGVHT 
HTML 语言 是 当前 主流 的 网 页 技术 ， 而 WebView 是 一 个 嵌入 式 的 浏览 器 ， 在 里 面 可 
以 直接 使 用 WebView.loadData(). WebView 将 HTML 标记 传递 给 WebView 对 象 ， 让 
Android 手机 程序 变 为 Web 浏览 器 。 这 样 ， 网 页 程序 被 放 在 了 WebView 中 运行 ， 如 同一 
个 Web Application. 
本 实例 的 具体 实现 流程 如 下 。 
(1) 编写 布局 文件 main.xml， 主 要 代码 如 下 : 
<LinearLayout 
xmlns:android-"http://schemas.android.com/apk/res/android" 
android:orientation-"vertical" 
android:background-"Gdrawable/white" 


android:layout width-"fill parent" 
android:layout height-"fill parent" 


> 
<!-- 创建 一 个 TextView --> 
<TextView 


android: id="@+id/myTextViewl" 
android:layout width="fill parent” 
android:layout height="wrap content" 
android: textColor="@drawable/blue" 
android:text="@string/hello" 


/> 
<!-- 创建 一 个 WebView --> 
<WebView 


android: id="@+id/myWebView1" 
android: layout height="wrap content" 
android:layout width="wrap content" 
/> 

</LinearLayout> 


(2) 编写 文件 HT java, 7E loadData 中 插入 了 预先 设置 好 的 HTML 代码 ， 通 过 HTML 
代码 显示 了 一 幅 图 片 和 文字 ， 并 且 实现 了 超级 链接 功能 。 具 体 代 码 如 下 : 


public class HT extends Activity 
t 
private WebView mWebViewl; 
public void onCreate (Bundle savedInstanceState) 
{ 
super.onCreate (savedInstanceState); 
setContentView (R.layout.main); 
mWebViewl = (WebView) findViewById(R.id.myWebViewl); 
/自行 设置 WebView 要 显示 的 网 页 内 容 */ 
mWebViewl. 
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loadData( 

"<htm1><body><p>aaaaaaa</p>" + 

"<div class-'widget-content'» "+ 

"<a href=http://www.sohu.com>" + 

"<img src-http://hiphotos.baidu.com/chaojihedan/pic/item/ 
bbddf5efc260f133fdfa3cd8.jpg />" + 

"<a href=http://www.sohu.com>Link Blog</a>" + 

"</body></htm1>", "text/html", "utf-8"); 
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执行 后 将 显示 HTML 产生 的 页 面 ， 如 图 6-6 所 示 。 单 击 超 链接 后 会 来 到 指定 的 目标 
面 。 


x 


图 6-6 执行 效果 


6.4.6 ”使 用 WebView 加 载 JavaScript 程 序 
| 实例 | “功能 “| — seme ——| 


实例 6-3 使 用 WebView 加 载 JavaScript 程序 下 载 路 径 :\daima\6\RIADemo 


在 本 实例 中 ， 预 先 准备 了 一 个 HTML 文件 和 一 个 JavaScript 文件 ， 本 实例 的 最 终 目 的 
是 在 加 载 HTML 的 同时 加 载 JavaScript 文件 ， 在 HTML 中 显示 手机 中 联系 人 的 信息 。 本 实 
例 的 具体 实现 流程 如 下 。 

(1) 准备 HTML 文件 phonebook.html， 具 体 代 码 如 下 : 


«html» 
<head> 
<script type="text/javascript" src="fetchcontacts.js"/> 
</head> 
<body> 
<div id = "contacts"> 
<p> this is a demo </p> 
</div> 
</body> 
</html> 
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(2) 准备 JavaScript 文件 fetchcontactsjs， 具 体 代码 如 下 : 


window.onload- function()( 
window.phonebook.debugout ("inside js onload"); 
/ NAH RIAExample.debugout 
var persons = window.phonebook.getContacts(); 
/ NAH RIAExample.getContacts () 
if (persons) {//persons 实际 上 是 JavaArrayJSWrapper WHR 
window.phonebook.debugout (persons.length() + " of contact 
entries are fetched"); 
var contactsE = document.getElementById ("contacts"); 
var i = 0; 
while(i < persons.length()) { 
//persons.length () iH] JavaArrayJSWrapper.length()JjiX 
pnode = document.createElement ("p"); 
//persons .get (i) ak## Person WR 
// 然 后 在 JS 里 面 直接 调用 getName () 和 getNumber () 获取 姓名 和 号 码 
tnode = document.createTextNode ("name : " + persons.get (i) .getName () 
+ " number : " + persons.get (i) .getNumber ()); 
pnode.appendChild (tnode) ; 
contactsE.appendChild (pnode) ; 
i ++; 
} 
}else{ 
window.phonebook.debugout ("persons is undefined"); 


} 
(3) 编写 布局 文件 main.xml， 在 其 中 添加 一 个 WebView 控件 。 主 要 代码 如 下 : 


<?xml version-"1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="fill parent" 
android:layout height="fill parent" 
= 
<WebView android: id="@+id/web" 
android: layout width="fill parent" android:layout height-"fill parent"> 
</WebView> 
</LinearLayout> 


(4) 编写 文件 Personjava. 7 XH Person 来 描述 一 个 联系 人 的 信息 ， 它 包含 联系 人 姓 
名 和 号 码 。 主 要 代码 如 下 : 


public class Person ( 
String name; 
String phone number; 
public String getName (){ 


return name; 
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public String getNumber() { 
return phone number; 


} 
(5) 编写 文件 JavaArrayJSWrapper.java， 主 要 代码 如 下 : 


public class JavaArrayJSWrapper { 
private Object[] innerArray; 


public JavaArrayJSWrapper (Object[] a){ 
this.innerArray = a; 


public int length() { 
return this.innerArray.length; 


public Object get(int index) { 
return this.innerArray [index]; 


} 
(6) 编写 测试 文件 RIAExample.java， 主 要 代码 如 下 : 


package com.example; 
import java.util.Vector; 


import android.app.Activity; 
import android.os.Bundle; 
import android.util.Log; 
import android.webkit.WebView; 


public class RIAExample extends Activity ( 
private WebView web; 
// 模 拟 号 码 短 
private Vector<Person> phonebook = new Vector«Person»(); 
/** Called when the activity is first created. */ 
@override 
public void onCreate (Bundle savedInstanceState) { 
super .onCreate (savedInstanceState) ; 
setContentView(R.layout.main) ; 
this.initContacts(); 
web = (WebView)this.findViewById(R.id.web); 
web.getSettings () .setJavaScriptEnabled (true); 
// 开 启 JavaScript 设置 ， 否 则 Webview 不 执行 JS 脚本 
web.addJavascriptInterface (this, "phonebook"); 
// 把 RIAExample 的 一 个 实例 添加 到 Js 的 全 局 对 象 window 中 ， 
// 这 样 就 可 以 使 用 window.phonebook 来 调用 它 的 方法 
web.loadUrl("file:///android asset/phonebook-html") ;// 加 载 网 页 
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/** 
* 该 方法 将 在 Ts 脚本 中 ， 通 过 window.phonebook.getContacts () 进行 调用 
* 返回 的 JavaarrayJSWrapper 对 象 可 以 使 得 在 Js 中 访问 Java 数组 
* @return 
Eu) 

public JavaArrayJSWrapper getContacts() { 
System.out.println("fetching contacts data"); 

Person[] a = new Person[this.phonebook.size()]; 
a = this.phonebook.toArray (a); 
return new JavaArrayJSWrapper (a); 


[** 
* CE STG 
Ey, 


public void initContacts() { 
Person p = new Person(); 
p-name = "Perter"; 
p-phone number = "8888888"; 
phonebook. add (p) ; 
p = new Person(); 
p.name = "wangpengl"; 
p-phone number = "13000000"; 
phonebook. add (p) ; 
) 
/ ** 
* 通过 window.phonebook.debugout 来 输出 Js 调试 信息 
* @param info 
vy 
public void debugout (String info) { 
Log.i("ss",info); 
System.out.println (info); 
) 
) 


执行 后 的 效果 如 图 6-7 所 示 。 


图 6-7 执行 效果 
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本 实例 的 目的 是 为 了 说 明 通过 WebView.addJavascriptInterface 方法 可 以 扩展 JavaScript 
的 API， 这 样 可 以 获取 Android 的 数据 。 由 此 可 见 ， 我 们 可 以 使 用 Dojo. jQuery 和 Protory 
等 JS 框架 来 搭建 Android 应 用 程序 ， 来 实现 更 加 绚丽 的 效果 。 


6.4.7 ”使 用 WebView 的 注意 事项 


基于 WebView 在 Android 浏览 器 领域 的 重要 性 ， 下 面 将 简单 讲解 在 使 用 WebView 时 
的 注意 事项 ， 帮 助 广大 读者 ， 特 别 是 初学 者 来 避免 一 些 不 必要 的 错误 和 麻烦 。 

(1) 在 文件 AndroidManifest.xml 中 必须 使 用 许可 android.permission INTERNET, fi Jlll 
会 出 现 “Web page not available” 的 错误 。 

(2) 如 果 访 问 的 页 面 中 有 JavaScript, ill] WebView 必须 设置 支持 JavaScript. 


webview.getSettings () .setJavaScriptEnabled (true); 


(3) 当 页 面 中 有 链接 ， 如 果 希 望 点 击 链接 继续 在 当前 Browser 中 响应 ， 而 不 是 在 新 开 
的 Android 系统 Browser 中 响应 该 链接 ， 必 须 覆 盖 WebView 的 WebViewClient 对 象 ， 例 如 
下 面 的 代码 : 
mWebView.setWebViewClient (new WebViewClient () { 
public boolean shouldOverrideUrlLoading (WebView view, 
String url) { 
view. loadUrl (url); 
return true; 


he 
(4) 如 果 不 做 任何 处 理 在 浏览 网 页 时 ， 点 击 系统 的 Back 键 ， 整 个 Browser 会 调用 
finish(O) 而 结束 自身 ， 如 果 和 希望 浏览 的 网 页 是 回 退 而 不 是 退出 浏览 器 ， 需 要 在 当前 Activity 
中 处 理 并 消耗 掉 该 Back 事件 。 例 如 下 面 的 代码 : 


public boolean onKeyDown (int keyCode, KeyEvent event) { 
if ((keyCode == KeyEvent.KEYCODE BACK) && mWebView.canGoBack()) 


mWebView.goBack(); 
return true; 


} 
return super.onKeyDown (keyCode, event); 


e x19 
在 Androi0 中 和 开发 蓝牙 应 用 


蓝牙 是 通信 和 领域 中 新 兴 的 一 个 专 有 名 词 ， 是 一 种 支持 设备 
短 距离 (一 般 10m 内 ) 通 信 的 无 线 电 技术 。 它 能 在 包括 移动 电 
话 、PDA、 无 线 耳 机 、 笔 记 本 电脑 、 相 关外 设 等 众多 设备 之 间 
进行 无 线 信息 交换 。 本 章 将 简要 介绍 在 Android 平台 中 开发 蓝 
牙 相关 应 用 的 基本 知识 。 


\ 
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71 蓝牙 系统 的 结构 


蓝牙 系统 比较 复杂 ， 但 是 又 很 常用 ， 要 想 完全 掌握 蓝牙 应 用 开发 技术 ， 我 们 需要 从 底 
层 做 起 ， 首 先 了 解 它 的 底层 结构 。 本 节 将 简要 讲解 蓝牙 系统 底层 结构 的 基本 知识 。 


7.1.1 蓝牙 概述 


利用 蓝牙 技术 ， 能 够 有 效 地 简化 移动 通信 终端 设备 之 间 的 通信 ， 也 能 够 成 功 地 简化 设 
备 与 Intemet 之 间 的 通信 ， 从 而 使 数据 传输 变 得 更 加 迅速 高 效 ， 为 无 线 通 信 拓 宽 道路 。 蓝 
牙 采 用 分 散 式 网 络 结构 以 及 快 跳 频 和 短 包 技术 ， 支 持 点 对 点 及 点 对 多 点 通信 ; 工作 在 全 球 
通用 的 2.4GHz ISM( 即 工业 、 科 学 、 医 学 ) 频 段 ， 数据 速率 为 1Mb/s; 采用 时 分 双 工 传输 方 
案 实现 全 双 工 传输 。 


1. 蓝牙 的 发 展 历程 


蓝牙 这 个 名 称 来 自 于 第 十 世纪 的 一 位 丹麦 国王 Harald Blatand，Blatand 在 英文 里 的 意 
思 可 以 被 解释 为 Bluetooth( 蓝 牙 )， 因 为 国王 喜欢 吃 蓝莓 ， 牙 龋 每 天 都 是 蓝 色 的 ， 所 以 
叫 蓝牙 。 

蓝牙 的 创始 人 是 瑞典 爱立信 公司 ， 爱 立信 早 在 1994 年 就 已 进行 研发 。1997 年 ， 爱 立 
信 与 其 他 设备 生产 商 联系 ， 并 激发 了 他 们 对 该 项 技术 的 浓厚 兴趣 。1998 年 2 月 ，5 个 跨国 
大 公司 ， 包 括 爱立信 、 诺 基 亚 、IBM、 东 芝 及 Intel 组 成 了 一 个 特殊 兴趣 小 组 (SIG)， 他 们 
共同 的 目标 是 建立 一 个 全 球 性 的 小 范围 无 线 通信 技术 ， 即 现在 的 蓝牙 。 

蓝牙 无 线 技术 规格 供 全 球 的 成 员 公 司 免费 使 用 。 许 多 行业 的 制造 商都 积极 地 在 其 产品 
中 实施 此 技术 ， 以 减少 使 用 零乱 的 电线 ， 实 现 无 颖 连接 、 流 传输 立体 声 ， 传 输 数 据 可 进行 
语音 通信 。 蓝 牙 技术 在 24 GHz 波段 运行 ， 该 波段 是 一 种 无 须 申请 许可 证 的 工业 、 科 技 、 
医学 (ISM) 无 线 电波 段 。 正 因 如 此 ， 使 用 蓝牙 技术 不 需要 支付 任何 费用 。 但 必须 向 手机 提 
供 商 注册 使 用 GSM 或 CDMA， 除 了 设备 费用 外 ， 不 需要 为 使 用 蓝牙 技术 再 支付 任何 
费用 。 

蓝牙 技术 得 到 了 空前 广泛 的 应 用 ， 集 成 该 技术 的 产品 从 手机 、 汽 车 到 医疗 设备 ， 使 用 
该 技术 的 用 户 从 消费 者 、 工 业 市 场 到 企业 ， 等 等 ， 不 一 而 足 。 低 功 耗 、 小 体积 以 及 低 成 本 
的 芯片 解决 方案 使 得 蓝牙 技术 甚至 可 以 应 用 于 极 微小 的 设备 中 。 

2. 蓝牙 的 特点 

蓝牙 技术 是 一 项 即时 技术 ， 它 不 要 求 固定 的 基础 设施 ， 且 易于 安装 和 设置 。 无 须 电缆 
即 可 实现 连接 。 新 用 户 使 用 亦 不 费力 ， 我 们 只 需 拥 有 蓝牙 品牌 产品 ， 检 查 可 用 的 配置 文 
件 ， 将 其 连接 至 使 用 同一 配置 文件 的 另 一 蓝牙 设备 即 可 。 后 续 的 PIN 码 流程 就 如 同 您 在 
ATM 机 器 上 操作 一 样 简单 。 外 出 时 ， 您 可 以 随身 带 上 您 的 个 人 局 域 网 PAN)， 甚 至 可 以 与 
其 他 网 络 连接 。 
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3. Android 中 的 蓝牙 

Android 包含 了 对 蓝牙 网 络 协议 栈 的 支持 ， 这 使 得 蓝牙 设备 能 够 无 线 连 接 其 他 蓝牙 设 
备 交 换 数据 。Android 的 应 用 程序 框架 提供 了 访问 蓝牙 功能 的 APIs， 这 些 APIs 让 应 用 程序 
能 够 无 线 连接 其 他 蓝牙 设备 ， 实 现 点 对 点 或 点 对 多 点 的 无 线 交 互 功能 。 

使 用 蓝牙 APIs, Android 应 用 程序 能 够 实现 以 下 功能 。 


口 


Oooco 


扫描 其 他 蓝牙 设备 。 

查询 本 地 蓝牙 适配器 (Local Bluetooth Adapter) 用 于 配对 蓝牙 设备 。 
建立 RFCOMM 信道 (channels)。 

通过 服务 发 现 (Service Discovery) 连 接 其 他 设备 。 

数据 通信 。 

管理 多 个 连接 。 


71.2 ”蓝牙 层次 结构 


Android 平台 的 蓝牙 系统 是 基于 Bluez 实现 的 ， 是 通过 NUX 中 一 套 完整 的 蓝牙 协议 栈 
开源 实现 的 。 当 前 Bluez 被 广泛 应 用 于 各 种 Linux 版 本 中 ， 并 被 芯片 公司 移植 到 各 种 芯片 
平台 上 来 使 用 。 在 Linux 2.6 内 核 中 已 经 包含 了 完整 的 BlueZ 协议 栈 ， 在 Android 系统 中 也 
已 移植 并 嵌入 了 Bluez 的 用 户 空间 实现 ， 并 且 随 着 硬件 技术 的 发 展 而 不 断 更 新 。 

蓝牙 技术 实际 上 是 一 种 短 距 离 无 线 电 技 术 。 在 Android 系统 中 的 蓝牙 除了 使 用 Kemel 


支持 外 ， 还 需要 用 户 空间 的 Bluez 的 支持 。 
Android 平台 中 蓝牙 系统 的 基本 层次 结构 如 图 7-1 所 示 。 


蓝牙 应 用 平台 API 


d 


Android.bluetooth& 


本 地 框架 


RI Android RE 


本 地 框架 Bluetooth JNI 
bluetooth 适 配 层 和 BlueZ 库 


$ 


蓝牙 设备 硬件 和 驱动 


7-1 蓝牙 系统 的 层次 结构 


Android 平台 中 蓝牙 系统 从 上 到 下 主要 包括 Java 框架 中 的 BlueTooth 类 、Android 适 配 
库 、BlueZ 库 、 驱 动 程序 和 协议 ， 这 几 部 分 的 系统 结构 如 图 7-2 所 示 。 


E. Andicid 网 络 开发 从 入 门 到 精通 


Vm 
android. bluetooth, 
中 的 各 个 类 
Java 框 架 层 


用 户 空间 eu B ^ cem 


内 核 空间 Fash (CART. USS..) 


图 7-2 ”蓝牙 系统 结构 
在 图 7-2 中 各 个 层次 结构 的 具体 说 明 如 下 。 


1. BlueZ 库 
Android 蓝牙 设备 管理 库 的 路 径 如 下 : 
external/bluez/ 


可 以 分 别 生 成 libbluetooth.so、libbluedroid.so 和 hcidump 等 众多 相关 工具 和 库 。BlueZ 
库 提供 了 对 用 户 空间 蓝牙 的 支持 ， 其 中 包含 了 主机 控制 协议 HCI 以 及 其 他 众多 内 核实 现 协 
议 的 接口 ， 并 且 实现 了 所 有 蓝牙 应 用 模式 Profile. 


2. 蓝牙 的 JNI 部 分 

此 部 分 的 代码 路 径 如 下 : 
frameworks/base/core/jni/ 

3. Javat R Iz 

Java 框架 层 的 实现 代码 保存 在 如 下 路 径 : 


frameworks/base/core/java/android/bluetooth // 蓝 牙 部 分 对 应 应 用 程序 的 API 
frameworks/base/core/java/android/Server // 蓝 牙 的 服务 部 分 


蓝牙 的 服务 部 分 负责 管理 并 使 用 底层 本 地 服务 ， 并 封装 成 系统 服务 。 而 在 
android.bluetooth 部 分 中 包含 了 各 个 蓝牙 平台 的 API 部 分 ， 以 供应 用 程序 层 所 使 用 。 
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4. BlueTooth 适 配 库 
BlueTooth 适 配 库 的 代码 路 径 如 下 : 
system/bluetooth/ 


在 此 层 用 于 生成 库 libbluedroid.so 以 及 相关 工具 和 库 ， 能 够 实现 对 蓝牙 设备 的 管理 ， 
例如 蓝牙 设备 的 电源 管理 。 


7.1.3 蓝牙 在 Android 和 Linux 中 的 差异 


在 Android 平台 中 ， 蓝 牙 系 统 的 本 地 层 和 框架 层 都 是 标准 的 程序 ， 仅 有 的 区 别 是 蓝牙 
了 驱动 程序 。 蓝 牙 驱 动 程序 包括 针对 硬件 接口 的 USB、SDIO 和 UART 驱动 ， 此 部 分 驱动 的 
内 容 也 是 标准 的 。 如 果 使 用 UART 蓝牙 芯片 ， 则 需要 使 用 芯片 特定 的 高 速 串 口 。 另 外 在 驱 
动 中 还 包含 了 电源 管理 和 芯片 配置 。 因 为 通常 硬件 接口 都 比较 标准 ， 所 以 有 很 多 蓝牙 芯片 
通过 用 户 空间 的 初始 化 代码 直接 对 芯片 进行 写 入 操作 ， 以 完成 初始 化 操作 。 

1. BlueZ 

Android 所 采用 的 蓝牙 用 库 空间 的 库 是 BlueZ。 它 是 一 套 Linux 平台 的 蓝牙 协议 栈 完 
整 开源 实现 ， 广 泛 应 用 在 各 Linux 发 行 版 ， 并 被 移植 到 众多 移动 平台 上 。 在 Android 系统 
中 ，BlueZ 提供 了 很 多 分 散 的 应 用 ， 例 如 守护 进程 和 一 些 工 具 。BlueZ 通过 D-BUS IPC 机 
制 来 提供 应 用 层 接口 。 

2. 适 配 层 

BlueZ 的 适 配 层 BlueZ 在 Android 中 使 用 ， 需 要 经 过 Android 的 BlueZ 适 配 层 的 封装 。 
BlueZ 适 配 层 源 代码 及 头 文件 路 径 如 下 : 

system/bluetooth/ 

该 目录 中 除了 包含 生成 适 配 层 库 libbluedroid.so 的 源码 之 外 ， 还 包含 了 BlueZ 头 文件 
和 BlueZ 配置 文件 等 目录 。 由 于 BlueZ 使 用 D-BUS 作为 与 上 层 沟通 的 接口 ， 适 配 层 构造 
比较 简单 ， 封 装 了 蓝牙 的 开关 功能 ， 以 及 射频 开关 。 

3. JNI 和 Java 部 分 

在 Android 中 还 定义 了 BlueTooth 通过 INI 到 上 层 的 接口 ， 此 功能 保存 在 如 下 目录 中 。 

frameworks/base/core/jni/ 

此 目录 中 的 主要 实现 文件 如 下 。 

口 android bluetooth BluetoothAudioGateway.cpp 


n 


ū android bluetooth common.cpp 

ū android bluetooth Database.cpp 

ū android bluetooth ScoSocket.cpp 

ū android bluetooth RfcommSocket.cpp 
ū android bluetooth HeadsetBase.cpp 
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要 想 掌握 蓝牙 的 开发 原理 ， 则 需要 分 析 Android 中 的 蓝牙 源码 并 了 解 其 核心 构造 ， 这 
样 才能 对 蓝牙 应 用 开发 做 到 游 轧 有余 。 本 节 将 简要 介绍 开源 Android 中 和 蓝牙 相关 的 
代码 。 


7.2.1 初始 化 蓝牙 芯片 


初始 化 蓝牙 芯片 是 通过 BlueZ 工具 hciattach 进行 的 ， 此 工具 在 以 下 目录 的 文件 中 

external/bluetooth/tools 

hciattach 命令 主要 用 来 初始 化 蓝牙 设备 ， 其 命令 格式 如 下 : 

hciattach [-n] [-p] [-b] [-t timeout] [-s initial speed] «tty» «type | 

id» [speed] [flow|noflow] [bdaddr] 

其 中 最 重要 的 参数 是 type 和 speed, type 决定 了 要 初始 化 的 设备 的 型 号 ， 可 以 使 用 
hciattach -1 来 列 出 所 支持 的 设备 型 号 。 

并 不 是 所 有 的 参数 对 所 有 的 设备 都 是 适用 的 ， 有 些 设 备 会 忽略 一 些 参数 设置 ， 例 如 ， 
查看 hciattach 的 代码 就 可 以 看 到 ， 多 数 设 备 都 忽略 bdaddr 参数 。hciattach 命令 内 部 的 工作 
步骤 是 : 首先 打开 制定 的 tty 设备 ， 然 后 做 一 些 通用 的 设置 ， 如 flow 等 ， 接 着 设置 波 特 率 
为 initial speed， 再 根据 type 调用 各 自 的 初始 化 代码 ， 最 后 将 波 特 率 重新 设置 为 speed。 所 
以 调用 hciattach 时 ， 要 根据 自己 的 实际 情况 ， 设 置 好 initial speed 和 speed. 

对 于 type BCSP 来 说 ， 它 的 初始 化 代码 只 做 了 一 件 事 ， 就 是 完成 BCSP 协议 的 同步 操 
作 ， 它 并 不 对 蓝牙 芯片 做 任何 的 pskey 的 设置 。 


7.22 ”蓝牙 服务 


在 蓝牙 服务 方面 一 般 不 用 我 们 自己 定义 ， 只 需要 使 用 初始 化 脚本 文件 initrc 中 的 默认 
内 容 即 可 。 例 如 下 面 的 代码 : 


service bluetoothd /system/bin/logwrapper /system/bin/bluetoothd -d -n 
socket bluetooth stream 660 bluetooth bluetooth 
socket dbus bluetooth stream 660 bluetooth bluetooth 
# init.rc does not yet support applying capabilities, so run as root and 
# let bluetoothd drop uid to bluetooth with the right linux capabilities 
group bluetooth net bt admin misc 
disabled 


# baudrate change 115200 to 1152000 (Bluetooth) 
service changebaudrate /system/bin/logwrapper /system/xbin/bccmd 115200 
-t bcsp -d /dev/s3c2410 seriall psset -r 0xlbe 0x126e 
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user bluetooth 

group bluetooth net bt admin 
disabled 

oneshot 


#service hciattach /system/bin/logwrapper /system/bin/hciattach -n -s 
1152000 /dev/s3c2410 seriall bcsp 1152000 
service hciattach /system/bin/logwrapper /system/bin/hciattach -n -s 
115200 /dev/s3c2410 seriall bcsp 115200 

user bluetooth 

group bluetooth net bt admin misc 

disabled 


service hfag /system/bin/sdptool add --channel-10 HFAG 
user bluetooth 
group bluetooth net bt admin 
disabled 
oneshot 


service hsag /system/bin/sdptool add --channel-11 HSAG 
user bluetooth 
group bluetooth net bt admin 
disabled 
oneshot 


service opush /system/bin/sdptool add --channel-12 OPUSH 
user bluetooth 
group bluetooth net bt admin 
disabled 
oneshot 


service pbap /system/bin/sdptool add --channel-19 PBAP 
user bluetooth 
group bluetooth net bt admin 
disabled 
oneshot 


在 上 述 代 码 中 ， 每 一 个 Service 后 面 列 出 了 一 种 Android 服务 。 


7.2.3 ”管理 蓝牙 电源 


在 Android 系统 的 目录 中 实现 了 libbluedroid。 


system/bluetooth/ 


我 们 可 以 调用 rfkill 接口 来 控制 电源 管理 。 如 果 已 经 实现 了 rfkill 接口 ， 则 无 须 再 进行 
配置 。 如 果 在 文件 initrc 中 已 经 实现 了 hciattach 服务 ， 则 说 明 在 libbluedroid 4 


调用 以 操作 蓝牙 的 初始 化 。 


P 己 经 实现 对 
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7.3 ”和 蓝牙 相关 的 类 


经 过 本 章 前 面 内容 的 学 习 ， 已 经 了 解 了 Android 系统 中 蓝牙 的 基本 知识 。 根 据 对 上 述 
从 底层 到 应 用 的 学 习 ， 了 解 了 蓝牙 的 工作 原理 和 机 制 。 本 节 将 详细 讲解 在 Android 系统 中 
和 蓝牙 相关 的 类 ， 为 读者 步 入 本 书后 面 知 识 的 学 习 打 好 基础 。 


7.3.1 BluetoothSocket 类 


1. BluetoothSocket 类 基础 
类 BluetoothSocket 的 格式 如 下 : 


public static class BluetoothSocket implements Closeable 


类 BluetoothSocket 的 结构 如 下 : 


java.lang.Object 

android.android.bluetoothSocket 

android.widget.android.bluetoothSocket 

Android 的 蓝牙 系统 和 Socket 套 接 字 密切 相关 ， 蓝 牙 端 的 监听 接口 和 TCP 的 端口 类 
似 ， 都 是 使 用 了 Socket 和 ServerSocket 类 。 在 服务 器 端 ， 使 用 BluetoothServerSocket 类 来 
创建 一 个 监听 服务 端口 。 当 一 个 连接 被 BluetoothServerSocket 所 接受 ， 它 会 返回 一 个 新 的 
BluetoothSocket 来 管理 该 连接 。 在 客户 端 ， 使 用 一 个 单独 的 BluetoothSocket 类 去 初始 化 一 
个 外 接连 接 和 管理 该 连接 。 

最 常 使 用 的 蓝牙 端口 是 RFCOMM， 它 是 被 Android API 支持 的 类 型 。RFCOMM 是 一 
个 面向 连接 、 通 过 蓝牙 模块 进行 的 数据 流传 输 方式 ， 它 也 被 称 为 串 行 端口 规范 (Serial Port 
Profile, SPP). 

为 了 创建 一 个 BluetoothSocket 类 去 连接 到 一 个 已 知 设备 ， 使 用 方法 
BluetoothDevice.createRfcommSocketToServiceRecord()， 然 后 调用 connect() 方 法 尝试 一 个 面 
向 远程 设备 的 连接 。 这 个 调用 将 被 阻塞 ， 直 到 一 个 连接 已 经 建立 或 者 该 连接 失效 。 

为 了 创建 一 个 BluetoothSocket 作为 服务 端 (或 者 “主机 ”)， 每 当 该 端口 连接 成 功 后 ， 
无 论 它 初始 化 为 客户 端 ， 或 者 被 接受 作为 服务 器 端 ， 都 通过 方法 getInputStream() 和 
getOutputStream() 来 打开 IO 流 ， 从 而 获得 各 自 的 InputStream 和 OutputStream 对 象 。 

BluetoothSocket 类 的 线程 是 安全 的 ， 因 为 close0 方 法 总 会 马上 放弃 外 界 操作 并 关闭 服 
务 器 端口 。 

2. BluetoothSocket 类 的 公共 方法 


1) public void close() 方 法 
功能 : 马上 关闭 该 端口 并 且 释 放 所 有 相关 的 资源 。 在 其 他 线程 的 该 端口 中 引起 阻塞 ， 
从 而 使 系统 马上 抛 出 一 个 IO 异常 。 
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异常 : IOException» 

2) public void connect() 方 法 

功能 : 尝试 连接 到 远程 设备 。 该 方法 将 阻塞 ， 直 到 一 个 连接 建立 或 者 失效 。 如 果 该 方 
法 没有 返回 异常 值 ， 则 该 端口 现在 已 经 建立 。 当 设备 查找 正在 进行 的 时 候 ， 不 可 尝试 创建 
对 远程 蓝牙 设备 的 新 连接 ， 因 为 在 蓝牙 适配器 上 ， 设 备查 找 是 一 个 重量 级 过 程 ， 并 且 会 降 
低 一 个 设备 的 连接 。 可 以 使 用 cancelDiscovery() 方 法 取消 一 个 外 界 的 查询 。 查 询 并 不 是 
活动 所 管理 ， 而 是 作为 一 个 系统 服务 来 运行 ， 所 以 即使 它 不 能 直接 请 求 一 个 查询 ， 应 用 程 
序 也 总 会 调用 cancelDiscovery() 方 法 。 用 close() 方 法 可 以 放弃 从 另 一 线程 而 来 的 调用 。 

异常 ,IOException， 表 示 一 个 错误 ， 例 如 连接 失败 。 

3) public InputStream getInputStream() 方 法 

功能 : 通过 连接 的 端口 获得 输入 数据 流 ， 即 使 该 端口 未 连接 ， 该 输入 数据 流 也 会 返 
回 。 不 过 在 该 数据 流 上 的 操作 将 抛 出 异常 ， 直 到 相关 的 连接 已 经 建立 。 

返回 值 : 输入 流 。 

异常 IOException. 

4) public OutputStream getOutputStream() 77 i; 

功能 : 通过 连接 的 端口 获得 输出 数据 流 ， 即 使 该 端口 未 连接 ， 该 输出 数据 流 也 会 返 
回 。 不 过 在 该 数据 流 上 的 操作 将 抛 出 异常 ， 直 到 相关 的 连接 已 经 建立 。 

返回 值 : 输出 流 。 

异常 IOException. 

5) public BluetoothDevice getRemoteDevice()7; id: 

功能 ， 获 得 该 端口 正在 连接 或 者 已 经 连接 的 远程 设备 。 

返回 值 ， 远 程 设备 。 


7.3.2 BluetoothServerSocket 类 


1. BluetoothServerSocket 类 基础 
类 BluetoothServerSocket 的 格式 如 下 : 


public final class BluetoothServerSocket extends Object implements Closeable 


类 BluetoothServerSocket 的 结构 如 下 : 


java.lang.Object 
android.bluetooth.BluetoothServerSocket 


2. BluetoothServerSocket 类 的 公共 方法 


1) public BluetoothSocketaccept(int timeout) 方 法 

功能 : 阻塞 ， 直 到 超时 时 间 内 的 连接 建立 。 在 一 个 成 功 建立 的 连接 上 返回 一 个 已 连接 
的 BluetoothSocket 类 。 每 当 该 调用 返回 的 时 候 ， 它 可 以 在 此 调用 去 接收 以 后 新 来 的 连接 。 
用 close() 方 法 可 以 放弃 从 另 一 线程 来 的 调用 。 

参数 : timeout， 表 示 阻 塞 超时 时 间 。 

返回 值 : 已 连接 的 BluetoothSocket。 


异常 : IOException， 表 示 出 现 错误 ， 比 如 该 调用 被 放弃 或 者 超时 。 

2) public void close() 方 法 

功能 : 马上 关闭 端口 ， 并 释放 所 有 相关 的 资源 。 在 其 他 线程 的 该 端口 中 引起 阻塞， 从 
而 使 系统 马上 抛 出 一 个 IO 异常 。 关 闭 BluetoothServerSocket 不 会 关闭 接收 自 accept0) 的 任 
意 BluetoothSocket。 

异常 : IOException. 


7.3.8 BluetoothAdapter2 


1. BluetoothAdapter 类 基础 
类 BluetoothAdapter 的 格式 如 下 : 


public final class BluetoothAdapter extends Object 


类 BluetoothAdapter 的 结构 如 下 : 

java.lang.Object 

android.bluetooth.BluetoothAdapter 

BluetoothAdapter 代表 本 地 的 蓝牙 适配器 设备 ， 通 过 此 类 可 以 让 用 户 能 执行 基本 的 蓝牙 
任务 。 例 如 初始 化 设备 的 搜索 、 查 询 可 匹配 的 设备 集 、 使 用 一 个 已 知 的 MAC 地 址 来 初始 
化 一 个 BluetoothDevice 类 、 创 建 一 个 BluetoothServerSocket 类 以 监听 其 他 设备 对 本 机 的 连 
接 请 求 等 。 

为 了 得 到 这 个 代表 本 地 蓝牙 适配器 的 BluetoothAdapter 类 ， 需 要 调用 静态 方法 
getDefaultAdapter()， 这 是 所 有 蓝牙 动作 使 用 的 第 一 步 。 当 拥有 本 地 适配器 以 后 ， 用 户 可 以 
获得 一 系列 的 BluetoothDevice 对 象 ， 这 些 对 象 代表 所 有 拥有 getBondedDevice0 方 法 的 已 经 
匹配 的 设备 ; 用 startDiscovery(0) 方 法 来 开始 设备 的 搜寻 ; 或 者 创建 一 个 
BluetoothServerSocket 类 ， 通 过 listenUsingRfcommWithServiceRecord(String，UUID) 方 法 来 
监听 新 来 的 连接 请 求 。 

EGER: 大 部 分 方法 需要 BLUETOOTH 权限 ， 一 些 方法 同时 需要 BLUETOOTH ADMIN 
权限 。 


2. BluetoothAdapter 类 的 常量 


1) String ACTION. DISCOVERY FINISHED 

广播 事件 : 本 地 蓝牙 适配器 已 经 完成 设备 的 搜寻 过 程 。 需 要 BLUETOOTH 权限 接收 。 

常量 值 : androidbluetooth.adapteraction.DISCOVERY FINISHED. 

2) String ACTION. DISCOVERY STARTED 

广播 事件 : 本 地 蓝牙 适配器 已 经 开始 对 远程 设备 的 搜寻 过 程 。 它 通常 涉及 一 个 大 概 需 
时 12 秒 的 查询 扫描 过 程 ， 紧 跟着 的 是 一 个 对 每 个 获取 到 自身 蓝牙 名 称 的 新 设备 的 页 面 扫 
描 。 用 户 会 发 现 一 个 把 ACTION FOUND 常量 通知 为 远程 蓝牙 设备 的 注册 。 设 备查 找 是 一 
个 重量 级 过 程 ， 当 查找 正在 进行 的 时 候 ， 用 户 不 能 尝试 对 新 的 远程 蓝牙 设备 进行 连接 ， 同 
时 存在 的 连接 将 获得 有 限制 的 带宽 以 及 高 等 待 时 间 。 用 户 可 用 cancelDiscovery0 类 来 取消 
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正在 执行 的 查找 进程 。 需 要 BLUETOOTH 权限 接收 。 
m1: android bluetooth.adapter.action DISCOVERY STARTED. 
3) String ACTION LOCAL NAME CHANGED 
广播 活动 : 本 地 蓝牙 适配器 已 经 更 改 了 它 的 蓝牙 名 称 。 该 名 称 对 远程 蓝牙 设备 是 可 见 
的 ， 它 总 是 包含 了 一 个 带 有 名 称 的 EXTRA LOCAL NAME 附加 域 。 需 要 BLUETOOTH 


常量 值 : android.bluetooth.adapter.action.LOCAL NAME CHANGED. 

4) String ACTION REQUEST DISCOVERABLE 

Activity 活动 : 显示 一 个 请 求 被 搜寻 模式 的 系统 活动 。 如 果 蓝 牙 模块 当前 未 打开 ， 该 
活动 也 将 请 求 用 户 打开 蓝牙 模块 。 被 搜寻 模式 和 SCAN MODE CONNECTABLE _ 
DISCOVERABLE 等 价 。 当 远程 设备 执行 查找 进程 的 时 候 ， 它 允许 其 发 现 该 蓝牙 适配器 。 
从 隐私 安全 考虑 ，Android 不 会 将 被 搜寻 模式 设置 为 默认 状态 。 该 意图 的 发 送 者 可 以 选择 
性 地 运用 EXTRA DISCOVERABLE DURATION 这 个 附加 域 去 请 求 发 现 设备 的 持续 时 
间 。 普 遍 来 说 ， 对 于 每 一 请 求 ， 默 认 的 持续 时 间 为 120 秒 ， 最 大 值 则 可 达到 300 秒 。 

Android 运用 onActivityResult(int, int, Intent) 回 收 方法 来 传递 该 活动 结果 的 通知 。 被 搜 
寻 的 时 间 ( 以 秒 为 单位 ) 将 通过 resultCode 值 来 显示 ， 如 果 用 户 拒绝 被 搜寻 ， 或 者 设备 产生 
了 错误 ， 则 通过 RESULT_CANCELED 值 来 显示 。 

每 当 扫 描 模式 变化 的 时 候 ， 应 用 程序 可 以 通过 ACTION SCAN MODE CHANGED fË 
来 监听 全 局 的 消息 通知 。 比 如 ， 当 设备 停止 被 搜寻 以 后 ， 该 消息 可 以 被 系统 通知 给 应 用 程 
序 。 需 要 BLUETOOTH 权限 。 

常量 值 : android.bluetooth.adapter.action REQUEST_DISCOVERABLE. 

5) String ACTION REQUEST ENABLE 

Activity 活动 : 显示 一 个 允许 用 户 打 开 蓝牙 模块 的 系统 活动 。 当 蓝牙 模块 完成 打开 工 
作 ， 或 者 当 用 户 决 定 不 打开 蓝牙 模块 时 ， 系 统 活动 将 返回 该 值 。Android 运用 
onActivityResult(int，int，Intent) 回 收 方法 来 传递 该 活动 结果 的 通知 。 如 果 蓝 牙 模块 被 打开 ， 
将 通过 resultCode 值 RESULT. OK 来 显示 ; 如 果 用 户 拒 绝 该 请 求 ， 或 者 设备 产生 了 错误 ， 
则 通过 RESULT CANCELED 值 来 显示 。 每 当 蓝 牙 模 块 被 打开 或 者 关闭 ， 应 用 程序 可 以 通 
it ACTION STATE CHANGED 值 来 监听 全 局 的 消息 通知 。 需 要 BLUETOOTH 权限 。 

常量 值 : android.bluetooth.adapteractionREQUEST ENABLE. 

6) String ACTION SCAN MODE CHANGED 

广播 活动 : 指明 蓝牙 扫描 模块 或 者 本 地 适配器 已 经 发 生变 化 。 它 总 是 包含 
EXTRA SCAN MODE 和 EXTRA PREVIOUS SCAN MODE。 这 两 个 附加 域 各 自 包含 了 
新 的 和 旧 的 扫描 模式 。 需 要 BLUETOOTH UR 

常量 值 : android.bluetooth .adapter.action.SCAN_ MODE CHANGED. 

7) String ACTION STATE CHANGED 

广播 活动 : 指明 蓝牙 适配器 的 状态 已 经 改变 ， 例 如 蓝牙 模块 已 经 被 打开 或 者 关闭 。 它 
总 是 包含 EXTRA STATE 和 EXTRA_PREVIOUS_STATE。 这 两 个 附加 域 各 自 包 含 了 新 的 
和 旧 的 状态 。 需 要 BLUETOOTH 权限 接收 。 

常量 值 : android.bluetooth.adapter.action.STATE CHANGED. 
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8) int ERROR 

功能 ， 标记 该 类 的 错误 值 ， 确 保 和 该 类 中 的 其 他 整数 常量 不 相等 。 它 为 需要 一 个 标记 
错误 值 的 函数 提供 了 便利 。 例 如 : 


Intent.getIntExtra (BluetoothAdapter.EXTRA STATE, BluetoothAdapter.ERROR) 


常量 值 ，-2147483648(0x80000000)。 

9) Sting EXTRA. DISCOVERABLE DURATION 

功能 : 试图 在 ACTION REQUEST DISCOVERABLE 常量 中 作为 一 个 可 选 的 整 型 附加 
域 ， 来 为 短 时 间 内 的 设备 发 送 请 求 一 个 特定 的 持续 时 间 。 默 认 值 为 120 秒 ， 超 过 300 秒 的 
请 求 将 被 限制 。 这 些 值 是 可 以 变化 的 。 

常量 值 : android.bluetooth.adapter.extra.DISCOVERABLE DURATION. 

10) String EXTRA. LOCAL NAME 

功能 : 试图 在 ACTION LOCAL NAME CHANGED 常量 中 作为 一 个 字符 串 附加 域 ， 
来 请 求 本 地 蓝牙 的 名 称 。 
常量 值 : android.bluetooth.adapter.extra.LOCAL NAME. 

11) String EXTRA. PREVIOUS SCAN MODE 

Xjfi£: 试图 在 ACTION SCAN MODE CHANGED 常量 中 作为 一 个 整 型 附加 域 ， 来 请 
求 以 前 的 扫描 模式 。 可 能 值 如 下 : 

Q SCAN MODE NONE 

Q SCAN MODE CONNECTABLE 

Q SCAN MODE CONNECTABLE DISCOVERABLE 

dtf: android.bluetooth.adapter.extra PREVIOUS SCAN MODE. 

12) String EXTRA. PREVIOUS STATE 

功能 : 试图 在 ACTION STATE CHANGED 常量 中 作为 一 个 整 型 附加 域 ， 来 请 求 以 前 
的 供电 状态 。 可 能 值 如 下 : 

Q STATE OFF 

Q STATE TURNING ON 

u STATE ON 

Q STATE TURNING OFF 

常量 值 : android.bluetooth.adapter.extra. PREVIOUS STATE. 

13) Sting EXTRA SCAN MODE 

功能 : 试图 在 ACTION. SCAN MODE CHANGED 常量 中 作为 一 个 整 型 附加 域 ， 来 请 
求 当 前 的 扫描 模式 ， 可 以 取 的 值 如 下 : 

Q SCAN MODE NONE 

Q SCAN MODE CONNECTABLE 

Q SCAN MODE CONNECTABLE DISCOVERABLE 

常量 值 : android.bluetooth.adapter.extra SCAN MODE. 

14) String EXTRA. STATE 

功能 : 试图 在 ACTION STATE CHANGED 常量 中 作为 一 个 整 型 附加 域 ， 来 请 求 当前 
的 供电 状态 。 可 以 取 的 值 如 下 : 
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Q STATE OFF 
Q STATE TURNING ON 
Q STATE ON 
STATE TURNING OFF 

dí 5t[H: android.bluetooth.adapter.extra.STATE. 

15)int SCAN MODE CONNECTABLE 

功能 : 指明 在 本 地 蓝牙 适配器 中 ， 查 询 扫描 功 能 失效 ， 但 页 面 扫描 功能 有 效 。 因 此 该 
设备 不 能 被 远程 蓝牙 设备 发 现 ， 但 如 果 以 前 曾经 发 现 过 该 设备 ， 则 远程 设备 可 以 对 其 进行 
连接 。 

常量 值 : 21(0x00000015)。 

16) int SCAN MODE CONNECTABLE DISCOVERABLE 

功能 : 指明 在 本 地 蓝牙 适配器 中 ， 查 询 扫描 功 能 和 页 面 扫描 功能 都 有 效 。 因 此 该 设备 
既 可 以 被 远程 蓝牙 设备 发 现 ， 也 可 以 被 其 连接 。 

常量 值 ，23 (0x00000017). 

17) int SCAN MODE NONE 

功能 : 指明 在 本 地 蓝牙 适配器 中 ， 查 询 扫描 功 能 和 页 面 扫描 功能 都 失效 。 因 此 该 设备 
既 不 能 被 远程 蓝牙 设备 发 现 ， 也 不 能 被 其 连接 。 

常量 值 ，20 (0x00000014). 

18) int STATE OFF 

功能 : 指明 本 地 蓝牙 适配器 模块 已 经 关闭 。 

常量 值 ，10 (0x0000000a)。 

19) int STATE ON 

功能 : 指明 本 地 蓝牙 适配器 模块 已 经 打开 ， 并 且 准 备 被 使 用 。 

20) int STATE TURNING OFF 

功能 : 指明 本 地 蓝牙 适配器 模块 正在 关闭 。 本 地 客户 端 可 以 立刻 尝试 友好 地 断 开 任意 
外 部 连接 。 

常量 值 ，13 (0x0000000d). 

21) int STATE TURNING ON 

功能 :指明 本 地 蓝牙 适配器 模块 正在 打开 。 然 而 本 地 客户 在 尝试 使 用 这 个 适配器 之 前 
需要 为 STATE_ON 状态 而 等 待 。 


D 


3. BluetoothAdapter 类 的 公共 方法 


1) public boolean cancelDiscovery() 方 法 

功能 : 取消 当前 的 设备 发 现 查找 进程 ， 需 要 BLUETOOTH ADMIN 权限 。 因 为 对 蓝牙 
适配器 而 言 ， 查 找 是 一 个 重量 级 的 过 程 ， 因 此 这 个 方法 必须 在 尝试 连接 到 远程 设备 前 使 用 
connect() 方 法 进行 调用 。 发 现 的 过 程 不 会 由 活动 来 进行 管理 ， 但 是 它 会 作为 一 个 系统 服务 
来 运行 ， 因 此 即使 它 不 能 直接 请 求 这 样 的 一 个 查询 动作 ， 也 必须 取消 该 搜索 进程 。 如 果 蓝 
牙 状 态 不 是 STATE ON， 这 个 API 将 返回 false。 蓝 牙 打开 后 ， 等 待 ACTION STATE 


e Android parsans 


CHANGED 更 新 成 STATE ON. 

返回 值 : 成 功 则 返回 tue， 有 错误 则 返回 false。 

2) public static boolean checkBluetoothAddress (String address) 方 法 

功能 : 验证 缘 如 “00:43:A8:23:10:F0” 之 类 的 蓝牙 地 址 ， 字 母 必 须 为 大 写 才 有 效 。 

GBR: address， 字 符 串 形式 的 蓝牙 模块 地 址 。 

返回 值 : 地 址 正确 则 返回 true, FUNE false. 

3) public boolean disable() 方 法 

功能 : 关闭 本 地 蓝牙 适配器 ， 不 能 在 没有 明确 关闭 蓝牙 的 用 户 动 作 中 使 用 。 这 个 方法 
友好 地 停止 所 有 的 蓝牙 连接 ， 停 止 蓝牙 系统 服务 ， 以 及 对 所 有 基础 蓝牙 硬件 进行 断 电 。 没 
有 用 户 的 直接 同意 ， 蓝 牙 永 远 不 能 被 禁止 。 这 个 disable() 方 法 只 提供 了 一 个 应 用 ， 该 应 用 
包含 了 一 个 改变 系统 设置 的 用 户 界 面 ， 例 如 电源 控制 应 用 。 

这 是 一 个 异步 调用 方法 : 该 方法 将 马上 获得 返回 值 ， 用 户 要 通过 监听 ACTION 
STATE CHANGED 值 来 获取 随后 的 适配器 状态 改变 的 通知 。 如 果 该 调用 返回 true 值 ， 则 
该 适配器 状态 会 立刻 从 STATE ON 转向 STATE TURNING OFF, ， 稍 后 则 会 转 为 
STATE OFF 或 者 STATE_ ON。 如 果 该 调用 返回 false， 那 么 说 明 系 统 已 经 有 一 个 保护 蓝牙 
适配器 被 关闭 的 问题 ， 比 如 该 适配器 已 经 被 关闭 了 。 

需要 BLUETOOTH ADMIN 权限 。 

返回 值 ， 如 果 蓝 牙 适 配器 的 停止 进程 已 经 开启 则 返回 tue， 如 果 产 生 错 误 则 返回 
false。 

4) public boolean enable() 方 法 

功能 : 打开 本 地 蓝牙 适配器 ， 不 能 在 没有 明确 打开 蓝牙 的 用 户 动 作 中 使 用 。 该 方法 将 
为 基础 蓝牙 硬件 供电 ， 并 且 启 动 所 有 的 蓝牙 系统 服务 。 没 有 用 户 的 直接 同意 ， 蓝 牙 永 远 不 
能 被 禁止 。 如 果 用 户 为 了 创建 无 线 连接 而 打开 了 蓝牙 模块 ， 则 其 需要 ACTION 
REQUEST ENABLE 值 ， 该 值 将 提出 一 个 请 求 用 户 允 许 以 打开 蓝牙 模块 的 会 话 。 这 个 
enable() 值 只 提供 了 一 个 应 用 ， 该 应 用 包含 了 一 个 改变 系统 设置 的 用 户 界面 ， 例 如 电源 控制 
应 用 。 

这 是 一 个 异步 调用 方法 : 该 方法 将 马上 获得 返回 值 ， 用 户 要 通过 监听 ACTION 
STATE CHANGED 值 来 获取 随后 的 适配器 状态 改变 的 通知 。 如 果 该 调用 返回 true 值 ， 则 该 
适配器 状态 会 立刻 从 STATE OFF 转向 STATE TURNING ON， 稍 后 则 会 转 为 STATE OFF 
或 者 STATE ON。 如果 该 调用 返回 false， 那 么 说 明 系 统 已 经 有 一 个 保护 蓝牙 适配器 被 打 
开 的 问题 ， 比 如 飞行 模式 ， 或 者 该 适配器 已 经 被 打开 。 

需要 BLUETOOTH_ADMIN 权限 。 

返回 值 : 如 果 蓝 牙 适 配器 的 打开 进程 已 经 开启 则 返回 tue， 如 果 产 生 错误 则 返回 
false。 

5) public String getAddress() 方 法 

功能 : 返回 本 地 蓝牙 适配器 的 硬件 地 址 ， 例 如 : 


00:11:22:AA:BB:CC 


需要 BLUETOOTH 权限 。 
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返回 值 : 字符 串 形 式 的 蓝牙 模块 地 址 。 

6) public Set<BluetoothDevice> getBondedDevices() 方 法 

功能 : 返回 已 经 匹配 到 本 地 适配器 的 BluetoothDevice 类 的 对 象 集合 。 如 果 蓝 牙 状 态 不 
是 STATE ON， 这 个 API 将 返回 false。 蓝 牙 打 开 后 ， 等 待 ACTION STATE CHANGED 
更 新 成 STATE _ ON。 需要 BLUETOOTH 权限 。 

返回 值 : 未 被 修改 的 BluetoothDevice 类 的 对 象 集合 ， 如 果 有 错误 则 返回 null。 

7) public static synchronized BluetoothAdapter getDefaultAdapter() 方 法 

功能 : 获取 对 默认 本 地 蓝牙 适配器 的 操作 权限 。 目 前 Android 只 支持 一 个 蓝牙 适 配 
器 ， 但 是 API 可 以 被 扩展 为 支持 多 个 适配器 。 该 方法 总 是 返回 默认 的 适配器 。 

返回 值 : 返回 默认 的 本 地 适配器 ， 如 果 蓝牙 适配器 在 该 硬件 平台 上 不 被 支持 ， 则 返回 
null. 

8) public String getName() 方 法 

功能 : 获取 本 地 蓝牙 适配器 的 蓝牙 名 称 ， 该 名 称 对 于 外 界 蓝牙 设备 而 言 是 可 见 的 。 需 
要 BLUETOOTH 权限 。 

BEHE: 该 蓝牙 适配器 名 称 ， 如 果 有 错误 则 返回 null. 

9) public BluetoothDevice getRemoteDevice (String address) 方 法 

功能 : 为 给 予 的 蓝牙 硬件 地 址 获取 一 个 BluetoothDevice 对 象 。 合 法 的 蓝牙 硬件 地 址 必 
须 为 大 写 ， 格 式 类 似 于 “00:11:22:33:AA:BB”。checkBluetoothAddress(String) 方 法 可 以 用 
来 验证 蓝牙 地 址 的 正确 性 。BluetoothDevice 类 对 于 合法 的 硬件 地 址 总 会 产生 返回 值 ， 即 使 
这 个 适配器 从 未 见 过 该 设备 。 

BY: address 合法 的 蓝牙 MAC 地 址 。 

异常 : IlegalArgumentException， 如 果 地 址 不 合法 。 

10) public int getScanMode() 方 法 

功能 : 获取 本 地 蓝牙 适配器 的 当前 蓝牙 扫描 模式 ， 蓝 牙 扫 描 模式 决定 本 地 适配器 可 连 
接 并 且 / 或 者 可 被 远程 蓝牙 设备 所 连接 。 需 要 BLUETOOTH 权限 ， 可 能 的 取 值 如 下 。 

Q SCAN MODE NONE 

Q SCAN MODE CONNECTABLE 

Q SCAN MODE CONNECTABLE DISCOVERABLE 

如 果 蓝 牙 状 态 不 是 STATE ON， 则 这 个 API 将 返回 false. MAH HI, ARS 
ACTION STATE CHANGED 更 新 成 STATE ON. 

返回 值 : 扫描 模式 。 

11) public int getState() 方 法 

功能 : 获取 本 地 蓝牙 适配器 的 当前 状态 ， 需 要 BLUETOOTH 类 。 可 能 的 取 值 如 下 : 

Q STATE OFF 

Q STATE TURNING ON 

Q STATE ON 

Q STATE TURNING OFF 

返回 值 : 蓝牙 适配器 的 当前 状态 。 

12) public boolean isDiscovering() 方 法 

功能 : 如 果 当 前 蓝牙 适配器 正 处 于 设备 发 现 查找 进程 中 ， 则 返回 true。 设 备查 找 是 一 
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个 重量 级 过 程 ， 当 查找 正在 进行 的 时 候 ， 用 户 不 能 尝试 对 新 的 远程 蓝牙 设备 进行 连接 ， 同 
时 存在 的 连接 将 获得 有 限制 的 带宽 以 及 高 等 待 时 间 。 用 户 可 用 cancelDiscovery0 类 来 取消 
正在 执行 的 查找 进程 。 
应 用 程序 也 可 以 为 ACTION DISCOVERY STARTED 或 ACTION DISCOVERY | 
FINISHED 进行 注册 ， 从 而 在 查找 开始 或 者 完成 的 时 候 ， 可 以 获得 通知 。 
如 果 蓝 牙 状 态 不 是 STATE ON， 这 个 API 将 返回 false。 蓝 牙 打 开 后 ， 等 待 ACTION 
STATE CHANGED 更 新 成 STATE ON。 需 要 BLUETOOTH 权限 。 
返回 值 : 如 果 正 在 查找 ， 则 返回 true. 
13) public boolean isEnabled() 方 法 
功能 : 如 果 蓝 牙 正 处 于 打开 状态 并 可 用 ， 则 返回 真 值 ， 与 getBluetoothState() 
—STATE ON 等 价 ， 需 要 BLUETOOTH 权限 。 
返回 值 : 如 果 本 地 适配器 已 经 打开 ， 则 返回 trues 
14) public BluetoothServerSocket listenUsingRfcommWithServiceRecord(String name, 
UUID m 
功能 : 创建 一 个 正在 监听 的 安全 的 带 有 服务 记录 的 无 线 射 频 通信 (RFCOMMDJ 蓝 牙 端 
口 。 一 个 对 该 端口 进行 连接 的 远程 设备 将 被 认证 ， 而 对 该 端口 的 通信 将 被 加 密 。 使 用 
accept() 方 法 可 以 获取 从 监听 BluetoothServerSocket 处 新 来 的 连接 。 该 系统 分 配 一 个 未 被 使 
用 的 无 线 射 频 通信 通道 来 进行 监听 。 
该 系统 也 将 注册 一 个 服务 探索 协议 (SDP) 记 录 ， 该 记录 带 有 一 个 包含 了 特定 的 通用 唯 
-识别 码 (Universally Unique Identifier，UUID)、 服务 器 名 称 和 自动 分 配 通道 的 本 地 SDP 服 
务 。 远 程 蓝牙 设备 可 以 用 相同 的 UUID 来 查询 自己 的 SDP 服务 器 ， 并 搜寻 连接 到 了 哪个 通 
道上 。 如 果 该 端口 已 经 关闭 ， 或 者 该 应 用 程序 异常 退出 ， 则 SDP 记录 会 被 移 除 。 使 用 
createRfcommSocketToServiceRecord(UUID) 可 以 从 另 一 使 用 相同 UUID 的 设备 来 连接 到 这 
个 端口 。 需 要 BLUETOOTH 权限 。 
参数 : 
口 name: SDP 记录 下 的 服务 器 名 。 
口 wid: SDP 记录 下 的 UUID。 
返回 值 ， 一 个 正在 监听 的 无 线 射频 通信 蓝牙 服务 端口 。 
异常 : IOException， 表 示 产 生 错误 ， 比 如 蓝牙 设备 不 可 用 ， 或 者 许可 无 效 ， 或 者 通道 
被 占用 。 
15) public boolean setName(String name) 方 法 
功能 : 设置 蓝牙 或 者 本 地 蓝牙 适配器 的 昵称 ， 这 个 名 字 对 于 外 界 蓝牙 设备 而 言 是 可 见 
的 。 合 法 的 蓝牙 名 称 最 多 拥有 248 位 UTF-8 字符 ， 但 是 很 多 外 界 设备 只 能 显示 前 40 个 字 
符 ， 有 些 可 能 只 显示 前 20 个 字符 。 
如 果 蓝 牙 状 态 不 是 STATE ON， 这 个 API 将 返回 false。 蓝 牙 打 开 后 ， 等 待 
ACTION STATE CHANGED 更 新 成 STATE_ ON。 需 要 BLUETOOTH ADMIN 权限。 
参数 : name， 一 个 合法 的 蓝牙 名 称 。 
返回 值 : 如 果 该 名 称 已 被 设 定 ， 则 返回 tue, MUE false. 
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16) public boolean startDiscovery() 方 法 

功能 : 开始 对 远程 设备 进行 查找 的 进程 ， 它 通常 涉及 一 个 大 概 需 时 12 秒 的 查询 扫描 
过 程 ， 紧 跟着 的 是 一 个 对 每 个 获取 到 自身 蓝牙 名 称 的 新 设备 的 页 面 扫 描 。 这 是 一 个 异步 调 
用 方法 ， 该 方法 将 马上 获得 返回 值 ， 注 册 ACTION DISCOVERY STARTED and 
ACTION DISCOVERY FINISHED 意图 准确 地 确定 该 搜索 是 处 于 开始 阶段 还 是 完成 阶段 。 
注册 ACTION FOUND 以 获得 远程 蓝牙 设备 已 找到 的 通知 。 

设备 查找 是 一 个 重量 级 过 程 。 当 查找 正在 进行 的 时 候 ， 用 户 不 能 尝试 对 新 的 远程 蓝牙 
设备 进行 连接 ， 同 时 存在 的 连接 将 获得 有 限制 的 带宽 以 及 高 等 待 时 间 。 用 户 可 用 
cancelDiscovery() 类 来 取消 正在 执行 的 查找 进程 。 发 现 的 过 程 不 会 由 活动 来 进行 管理 ， 但 是 
它 会 作为 一 个 系统 服务 来 运行 ， 因 此 即使 它 不 能 直接 请 求 这 样 的 一 个 查询 动作 ， 也 必须 取 
消 该 搜索 进程 。 设 备 搜寻 只 寻找 已 经 被 连接 的 远程 设备 。 许 多 蓝牙 设备 默认 不 会 被 搜寻 
到 ， 并 且 需 要 进入 到 一 个 特殊 的 模式 当中 。 

如 果 蓝 牙 状态 不 是 STATE ON， 这 个 API 将 返回 false。 蓝 牙 打 开 后 ， 等 待 
ACTION STATE CHANGED 更 新 成 STATE_ON。 需 要 BLUETOOTH. ADMIN 权限 。 

返回 值 : 成 功 返回 tue， 错 误 返 回 false. 


7.3.4 BluetoothClass.Service 类 


类 BluetoothClass.Service 的 格式 如 下 : 


public static final class BluetoothClass.Service extends Object 
类 BluetoothClass.Service 的 结构 如 下 : 


java.lang.Object 
android.bluetooth.BluetoothClass.Service 
BluetoothClass.Service 类 用 于 定义 所 有 的 服务 类 常量 ， 任 意 BluetoothClass 由 0 个 或 多 

个 服务 类 编码 组 成 。 类 BluetoothClass.Service 中 包含 如 下 常量 。 
Q int AUDIO 

int CAPTURE 

int INFORMATION 

int LIMITED DISCOVERABILITY 

int NETWORKING 

int OBJECT TRANSFER 

int POSITIONING 

int RENDER 

int TELEPHONY 


ocooooooodo 


7.3.5 BluetoothClass.Device.Major2 


类 BluetoothClass.Device.Major 的 格式 如 下 : 
public static class BluetoothClass.Device.Major extends Object 
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类 BluetoothClass.Device.Major 的 结构 如 下 : 


java.lang.Object 
android.bluetooth.BluetoothClass.Device.Major 
类 BluetoothClass.Device.Major 用 于 定义 所 有 的 主要 设备 类 常量 ， 各 个 常量 如 下 。 
口 intAUDIO VIDEO 

int COMPUTER 

int HEALTH 

int IMAGING 

int MISC 

int NETWORKING 

int PERIPHERAL 

int PHONE 

int TOY 

int UNCATEGORIZED 

int WEARABLE 


7.3.6 BluetoothClass.DeviceZs 


DODDCODDDUDDU 


类 BluetoothClass.Device 的 格式 如 下 : 
public final class BluetoothClass.Device extends Object 
类 BluetoothClass.Device 的 结构 如 下 : 


java.lang.Object 
android.bluetooth.BluetoothClass.Device 


类 BluetoothClass.Device 用 于 定义 所 有 的 设备 类 的 常量 ， 每 个 BluetoothClass 有 一 个 带 
有 主要 和 较 小 部 分 的 设备 类 进行 编码 。 其 中 的 常量 代表 主要 和 较 小 的 设备 类 部 分 (完整 的 设 
备 类 ) 的 组 合 。 

BluetoothClass.Device 有 一 个 内 部 类 ， 此 内 部 类 定义 了 所 有 的 主要 设备 类 常量 。 内 冰 
类 的 定义 格式 如 下 : 


class BluetoothClass.Device 


7.3.7 BluetoothClass# 


1. BluetoothClass 类 基础 
类 BluetoothClass 的 格式 如 下 : 


public final class BluetoothClass extends Object implements Parcelable 
类 BluetoothClass 的 结构 如 下 : 


java.lang.Object 
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android.bluetooth.BluetoothClass 


类 BluetoothClass 代表 一 个 描述 了 设备 通用 特性 和 功能 的 蓝牙 类 。 比 如 一 个 蓝牙 类 会 
指定 如 电话 、 计 算 机 或 耳机 的 通用 设备 类 型 ， 可 以 提供 如 音频 或 者 电话 的 服务 。 每 个 蓝牙 
类 都 是 由 0 个 或 更 多 的 服务 类 ， 以 及 一 个 设备 类 组 成 。 设 备 类 将 被 分 解 成 主要 和 较 小 的 设 
备 类 部 分 。 

BluetoothClass 用 作 能 粗略 描述 一 个 设备 (比如 关闭 用 户 界面 上 一 个 图 标的 设备 ) 
的 搜索 ， 但 当 蓝 牙 服 务 事实 上 是 被 一 个 设备 所 支撑 的 时 候 ，BluetoothClass 的 描述 
则 不 那么 可 信任 。 精 确 的 服务 搜寻 通过 SDP 请 求 来 完成 。 当 运用 
createRfcommSocketToServiceRecord(UUID) 和 listenUsingRfcommWithServiceRecord(String, 
UUID) 来 创建 RFCOMM 端口 的 时 候 ，SDP 请 求 就 会 自动 执行 。 

使 用 getBluetoothClass() 方 法 可 以 获取 为 远程 设备 所 提供 的 类 。 

2. BluetoothClass 类 的 内 部 类 


BluetoothClass 类 有 以 下 两 个 内 部 类 。 
OQ class BluetoothClass.Device: 用 于 定义 所 有 设备 类 的 常量 。 
Q class BluetoothClass.Service: 用 于 定义 所 有 服务 类 的 常量 。 


3. BluetoothClass 类 的 公共 方法 


1) public int describeContents() 方 法 

功能 : 描述 包含 在 可 封装 编组 的 表示 中 所 有 特殊 对 象 的 种 类 。 

返回 值 : 一 个 指示 被 Parcelabel 所 排列 的 特殊 对 象 类 型 集合 的 位 掩 码 。 

2) public boolean equals(Object 0) 方 法 

功能 :比较 带 有 特定 目标 的 常量 ， 如 果 相 等 则 标示 出 来 。 为 了 保证 其 相等 ，o 必须 代 
表 相 同 的 对 象 ， 该 对 象 作为 这 个 使 用 类 依赖 比较 的 常量 。 通 常 约定 ， 该 比较 既 要 可 移植 又 
HRM. HHNH o 是 一 个 作为 接收 器 (使 用 一 操作 符 来 做 比较 ) 的 精确 相同 的 对 象 时 ， 这 
个 对 象 的 实现 才 返 回 true 值 。 子 类 通常 实现 equals(Object) 方 法 ， 这 样 它 才 会 重视 这 两 个 对 
象 的 类 型 和 状态 。 

在 Android 中 约定 ， 对 于 equals(Object) 和 hashCode() 方 法 ， 如 果 equals 对 于 任意 两 个 
对 象 返回 真 值 ， 那 么 hashCode0) 必 须 对 这 些 对 象 返回 相同 的 值 。 这 意味 着 对 象 的 子 类 通常 
都 覆盖 或 者 都 不 覆盖 这 两 个 方法 。 

BR: 需要 对 比 常量 的 对 象 。 

返回 值 : 如 果 特 定 的 对 象 和 该 对 象 相等 则 返回 tue， 和 否则 返回 false. 

3) public int getDeviceClass() 方 法 

功能 :返回 BluetoothClass 中 的 设备 类 部 分 (主要 的 和 较 小 的 )， 从 函数 中 返回 的 值 可 以 
和 在 BluetoothClass.Device 中 的 公共 常量 做 比较 ， 从 而 确定 哪个 设备 类 在 这 个 蓝牙 类 中 是 
被 编码 的 。 

返回 值 ， 设 备 类 部 分 。 

4) public int getMajorDeviceClass() 方 法 

功能 : 返回 BluetoothClass 中 设备 类 的 主要 部 分 ， 从 函数 中 返回 的 值 可 以 和 在 
BluetoothClass.Device.Major 中 的 公共 常量 作 比 较 ， 从 而 确定 哪个 主要 类 在 这 个 蓝牙 类 中 是 
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被 编码 的 。 
返回 值 : 主要 设备 类 部 分 。 
5) public boolean hasService(int service) 方 法 
功能 : 如 果 该 指定 服务 类 被 BluetoothClass 所 支持 ， 则 返回 tme. TE 
BluetoothClass.Service 中 ， 合 法 的 服务 类 是 公共 常量 ， 比 如 AUDIO 类 。 
参数 : Service 合法 服务 类 。 
返回 值 : 如 果 该 服务 类 可 被 支持 ， 则 返回 true. 
6) public int hashCode() 方 法 
功能 : 返回 这 个 对 象 的 整 型 哈 希 码 。 按 约定 ， 任 意 两 个 在 equals(Object) 中 返回 true 的 
对 象 必 须 返 回 相同 的 哈 希 码 。 这 意味 着 对 象 的 子 类 通常 都 覆盖 或 者 都 不 覆盖 这 两 个 方法 。 
除非 同等 对 比 信息 发 生 改 变 ， 和 否则 哈 希 码 不 随时 间 改 变 而 改变 。 
返回 值 :该 对 象 的 哈 希 码 。 
7) public String toString() 方 法 
功能 : 返回 这 个 对 象 的 字符 串 ， 该 字符 串 包 含 精确 且 可 读 的 描述 。 系 统 鼓 励 子 类 去 重 
写 该 方法 ， 并 且 提 供 了 能 对 该 对 象 的 类 型 和 数据 进行 重 构 的 实现 方法 。 默 认 的 实现 方法 只 
是 简单 地 把 类 名 、“@” 符 号 和 该 对 象 hashCode() 方 法 的 十 六 进 制 数 连接 起 来 。 
返回 值 ， 该 对 象 中 一 个 可 被 打印 的 字符 串 。 
8) public void writeToParcel(Parcel out, int flags) 方 法 
功能 : 将 类 的 数据 写 入 外 部 提供 的 Parcel 中 。 
BR: 
Q out: 对 象 需要 被 写 入 的 Parcels 
Q flags: 对 象 需要 如 何 被 写 入 有 关 的 附加 标志 。 可 能 是 0， 或 者 可 能 是 
PARCELABLE WRITE RETURN VALUE。 
KR 注意 ; ”到 此 为 止 ， Android 中 的 蓝牙 类 介绍 完毕 。 我 们 在 调用 这 些 类 时 要 注意 ， 首 
先 确保 API Level 至 少 为 版 本 5 以 上 ， 并 且 还 需 注意 添加 相应 的 权限 ， 比 如 
在 使 用 通信 时 需要 在 文件 androidmanifestxml 中 加 入 <uses-permission 
android:name="android permission .BLUETOOTH'" /> 权限 ， 而 在 开关 蓝牙 时 需 
要 加 入 android.permission.BLUETOOTH ADMIN 权限 。 


7.4 Android 蓝牙 的 基本 应 用 


经 过 前 面 内 容 的 学 习 ， 已 经 了 解 了 Android 系统 中 和 蓝牙 功能 相关 的 类 。 本 节 将 简要 
介绍 Android 蓝牙 开发 中 常见 应 用 功能 的 基本 知识 ， 为 读者 步 入 本 书后 面 内 容 的 学 习 打 下 
基础 。 


7.4.1 使 用 BluetoothAdapter 类 


通过 使 用 BluetoothAdapter 类 ， 我 们 可 以 在 Android 设备 上 查找 周边 的 蓝牙 设备 ， 然 
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后 配对 或 绑 定 。 蓝 牙 通 信 是 基于 唯一 地 址 MAC 来 相互 传输 的 ， 考 虑 到 安全 问题 ， 蓝 牙 通 
信 时 需要 先 配对 ， 然 后 开始 相互 连接 ， 连 接 后 设备 将 会 共享 同一 个 RFCOMM 通道 以 便 相 
互 传输 数据 。 
1. 查找 发 现 蓝牙 设备 
在 Android 中 查找 发 现 蓝牙 设备 时 ， 使 用 BluetoothAdapter 类 的 startDiscovery() 方 法 即 
可 执行 一 个 异步 方式 获取 周边 的 蓝牙 设备 ， 因 为 这 是 一 个 异步 的 方法 ， 所 以 我 们 不 需要 考 
虑 线程 被 阻塞 问题 ， 整 个 过 程 大 约 需要 12 秒 。 这 时 需要 紧 接着 注册 一 个 BroadcastReceiver 
对 象 来 接收 查找 到 的 蓝牙 设备 信息 ， 通 过 过 滤 ACTION FOUND Intent 动作 可 以 获取 每 个 
远程 设备 的 详细 信息 ， 也 就 是 在 Intent 字段 通过 附加 参数 EXTRA DEVICE 和 
EXTRA CLASS 来 获取 ， 在 其 中 包含 了 每 个 BluetoothDevice 对 象 和 对 象 的 该 设备 类 型 
BluetoothClass。 下 面 是 查找 发 现 蓝牙 设备 的 演示 代码 。 
private final BroadcastReceiver cwjReceiver = new BroadcastReceiver() ( 
public void onReceive(Context context, Intent intent) ( 
String action = intent.getAction(); 
if (BluetoothDevice.ACTION FOUND.equals(action)) ( 
BluetoothDevice device - intent.getParcelableExtra 
(BluetoothDevice.EXTRA DEVICE); 


myArrayAdapter.add(device.getName() + " android123 " + 
device.getAddress()); // 获 取 设 备 名 称 和 MAC 地 址 


} 
u 
// 注册 这 个 BroadcastReceiver 
IntentFilter filter = new IntentFilter(BluetoothDevice.ACTION FOUND); 
registerReceiver(cwjReceiver, filter); 


在 这 个 过 程 中 读者 需要 注意 ， 务 必 在 Service BK Activity 中 重 写 onDestory() 方 法 ， 使 用 
unregisterReceiver 方法 来 注册 BroadcastReceiver 对 象 以 保证 资源 被 正确 回收 。 


2. 配对 绑 定 蓝牙 设备 


在 Android 系统 配对 一 个 蓝牙 设备 时 ， 可 以 调用 BluetoothAdapter 类 的 getBondedDevices() 
方法 来 获取 已 经 配对 的 设备 ， 该 方法 将 会 返回 一 个 BluetoothDevice 数组 来 区 分 每 个 已 经 配 
对 的 设备 。 例 如 下 面 的 演示 代码 。 

Set<BluetoothDevice> pairedDevices = 

cwjBluetoothAdapter.getBondedDevices(); 

if (pairedDevices.size() > 0) // 如 果 获取 的 结果 大 于 0， 则 开始 逐个 解析 


t 
for (BluetoothDevice device : pairedDevices) ( 
// 获 取 每 个 设备 的 名 称 和 MAC 地 址 添加 到 数组 适配器 myArrayAdapter 中 
myArrayAdapter.add(device.getName() + " android123 " + 
device.getAddress()); 


} 
要 想 让 别人 的 蓝牙 设备 发 现 自己 的 设备 ， 则 需要 设置 自己 的 机 器 。 要 用 户 确认 操作 ， 
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不 需要 获取 底层 蓝牙 服务 实例 ， 只 需 通 过 一 个 Intent 来 传递 
ACTION REQUEST DISCOVERABLE 参数 即 可 。 这 里 通过 startActivityForResult 来 强制 
获取 一 个 结果 ， 重 写 startActivityForResult() 方 法 获取 执行 结果 。 返 回 结果 有 RESULT. OK 
和 RESULT CANCELLED， 分 别 代表 开启 和 取消 (失败 )， 当 然 最 简单 的 方法 是 直接 执行 。 
下 面 是 演示 代码 。 

Intent cwjIntent = new 

Intent (BluetoothAdapter.ACTION REQUEST DISCOVERABLE) ; 


cwjIntent.putExtra (BluetoothAdapter.EXTRA DISCOVERABLE DURATION, 300); 
startActivity (cwjIntent) ; 


设置 完成 后 ， 系 统 会 弹出 一 个 询问 用 户 是 否 允 许 的 对 话 框 。 

3. 建立 通信 

建立 一 个 蓝牙 通信 必须 经 过 四 个 步 又， 分别 是 获取 本 地 蓝牙 设备 、 查 找 远程 设 备 、 配 
对 (已 配对 设备 将 会 忽略 这 步 的 细节 )、 连 接 设 备 和 传输 数据 。 

在 Android 平台 中 需要 先 查找 本 地 活动 的 蓝牙 适配器 ， 通 过 BluetoothAdapter 类 的 
getDefaultAdapter() 方 法 获得 一 个 系统 默认 可 用 的 蓝牙 设备 ， 例 如 下 面 的 代码 ; 

BluetoothAdapter cwjBluetoothAdapter = 
BluetoothAdapter.getDefaultAdapter(); 
if (cwjBluetoothAdapter -- null) ( 
// Android 开发 网 提示 大 家 本 机 没有 找到 蓝牙 硬件 或 驱动 存在 问题 
} 

经 过 上 述 代码 后 还 不 知道 手机 中 的 蓝牙 功能 是 否 被 开启 ， 我 们 可 以 通过 
cwjBluetoothAdapter 的 isEnabled() 方 法 来 判断 ， 如 果 没 有 开启 ， 可 以 通过 下 面 的 代码 提醒 
用 户 开 启 。 

if (!cwjBluetoothAdapter.isEnabled()) ( 
Intent TurnOnBtIntent - new 


Intent (BluetoothAdapter.ACTION REQUEST ENABLE); 
startActivityForResult(TurnOnBtIntent, REQUEST ENABLE BT); 


l 

此 时 会 弹出 开启 提醒 对 话 框 。 通 过 方法 startActivityForResult0 发 起 的 Intent 将 会 在 
onActivityResult0 回 调 方法 中 获取 用 户 的 选择 。 比 如 用 户 单 击 了 Yes 开启 ， 那 么 将 会 收 到 
RESULT OK 的 结果 ， 如 果 收 到 RESULT_CANCELED 结果 ， 则 代表 用 户 不 愿意 开启 蓝牙 。 

当然 也 可 以 通过 其 他 方式 来 开启 。 例 如 用 BluetoothDevice 获取 蓝牙 服务 接口 对 象 ， 然 
后 用 enable(0 方 法 来 开启 ， 此 方法 无 须 询 问 用 户 ， 但 需要 用 到 android.permission. 
BLUETOOTH ADMIN 权限 。 

该 如 何 判 断 系 统 蓝牙 的 状态 呢 ? 建立 BroadcastReceiver 对象， 接收 
ACTION STATE CHANGED 动作 , 在 EXTRA STATE 和 EXTRA PREVIOUS STATE 
包含 了 现在 状态 和 过 去 状态 ， 最 终 的 结果 定义 是 STATE TURNING ON 正在 开启 、 
STATE ON 已 经 开启 、STATE TURNING OFF 正在 关闭 和 STATE OFF 已 经 关闭 。 
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7.4.2 使 用 BluetoothSocket 类 


通过 使 用 BluetoothSocket 类 可 以 建立 和 蓝牙 有 关 的 通信 套 接 字 。 蓝 牙 和 LAN 一 样 通 
过 MAC 地 址 来 识别 远程 设备 ， 建 立 完 通 信 连 接 RFCOMM 通道 后 以 输入 、 输 出 流 方式 进 
行 通 信 。 
1. 连接 设备 
蓝牙 通信 和 Java 的 C/S 通信 过 程 一 样 ， 也 分 为 Server 服务 器 端 和 Client 客户 端 ， 它 们 
之 间 使 用 BluetoothSocket 类 的 不 同方 法 来 获取 数据 。 
1) 作为 服务 器 端 
如 果 一 个 设备 需要 和 两 个 或 多 个 设备 连接 时 ， 就 需要 作为 一 个 Server 来 传输 。 在 
Android 中 提供 了 BluetoothServerSocket 类 来 处 理 用 户 发 来 的 信息 ， 服 务 器 端 套 接 字 在 
accepted 接收 一 个 客户 发 来 的 BluetoothSocket 时 会 做 出 对 应 的 响应 。 例 如 下 面 的 代码 : 
private class AcceptThread extends Thread { 
private final BluetoothServerSocket cwjServerSocket; 
public AcceptThread() ( 


BluetoothServerSocket tmp - null; 
// 使 用 一 个 临时 对 象 代替 ， 因 为 cwjServerSocket 定义 为 final 


try ( 
tmp = myAdapter.listenUsingRfcommWithServiceRecord (NAME, 
CWJ UUID); // 服 务 仅 监听 
) catch (IOException e) { ) 
cwjServerSocket = tmp; 
) 
public void run() { 
BluetoothSocket socket - null; 
while (true) ( // 保 持 连 接 ， 直 到 异常 发 生 或 套 接 字 返 回 
try ( 
socket = cwjServerSocket.accept(); // 如 果 一 个 连接 同意 
) catch (IOException e) ( 
break; 
} 
if (socket != null) { 
manageConnectedSocket (socket) ; 
// 管 理 一 个 已 经 连接 的 RFCOMM 通道 在 单独 的 线程 
cwjServerSocket.close(); 
break; 


H 
H 
public void cancel() ( // 取 消 套 接 字 连接 ， 然 后 线程 返回 
tey i 
cwjServerSocket.close(); 
) catch (IOException e) { } 
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塞 的 目的 ， 必 须 使 用 异步 的 方法 打开 一 个 线程 ， 正 如 我 们 上 面 的 演示 代码 那样 。 目 前 
Android 的 虚拟 机 上 层 没 有 提供 VO 模型 ， 所 以 很 有 必要 在 高 负载 情况 下 实现 性 能 优化 解决 
方案 。 

2) 作为 客户 端 

在 客户 端 ， 为 了 便于 初始 化 连接 到 远程 设备 ， 首 先 必 须 获取 本 地 的 BluetoothDevice 对 
象 ， 相 关 的 方法 在 Android 蓝牙 API 之 BluetoothAdapter 类 的 两 个 地 方 都 有 讲 到 ， 这 里 不 
FBGA, DCI ARGU FE 

private class ConnectThread extends Thread { 
private final BluetoothSocket cwjSocket; 
private final BluetoothDevice cwjDevice; 
public ConnectThread(BluetoothDevice device) { 
BluetoothSocket tmp= null; 
cwjDevice= device; 


try { 
tmp= device.createRfcommSocketToServiceRecord(CWJ UUID); 
// 客 户 端 创建 
) catch (IOException e) ( ) 
cwjSocket= tmp; 


} 
public void run() ( 
myAdapter.cancelDiscovery(); // 取 消 发 现 远程 设备 ， 这 样 会 降低 系统 性 能 
Ery i 
cwjSocket.connect (); 
) catch (IOException connectException) ( 
bry f 
cwjSocket.close(); 
) catch (IOException closeException) ( } 
return; 


manageConnectedSocket (cwjSocket) ; 
// 管 理 一 个 已 经 连接 的 RFCOMM 通道 在 单独 的 线程 
} 
public void cancel() { 
try { 
cwjSocket.close(); 
) catch (IOException e) { ) 


) 


2. 管理 蓝牙 套 接 字 的 连接 
此 过 程 仍然 使 用 BluetoothSocket 类 来 处 理 具 体 的 数据 流 。 在 Java 中 处 理 数据 流 很 简 
单 ， 通 过 InputSream、OutputSream 和 字 节 数组 之 间 的 转化 即 可 处 理 完毕 。 由 于 蓝牙 传输 
中 可 能 存在 中 断 ， 所 以 为 了 防止 阻塞 ， 需 要 设置 一 个 工作 者 线程 。 例 如 下 面 的 演示 代码 : 
Private class ConnectedThread extends Thread { 
private final BluetoothSocket cwjSocket; 
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private final InputStream cwjInStream; 
private final OutputStream cwjOutStream; 
public ConnectedThread(BluetoothSocket socket) ( 
cwjSocket = socket; 
InputStream tmpIn = null; 
OutputStream tmpOut = null; 
try ( 
tmpIn = socket.getInputStream(); 
tmpOut = socket.getOutputStream(); 
} catch (IOException e) { } 
cwjInStream = tmpIn; 
cwjOutStream = tmpout; 
5 
public void run() { 
byte[] buffer - new byte[1024]; 
int bytes; 
while (true) ( 


tty f 
bytes = cwjInStream. read (buffer) ; 
// 传 递 给 UI 线程 


mHandler.obtainMessage (MESSAGE READ, bytes, -1, 
buffer).sendToTarget () ; 

) catch (IOException e) ( 

break; 


) 
} 
public void write(byte[] bytes) { 
try ( 
cwjOutStream.write (bytes) ; 
} catch (IOException e) { } 
} 
public void cancel() { 
try ( 
cwjSocket.close(); 
) catch (IOException e) { } 


} 


// 上 面 定义 的 为 final， 这 是 使 用 temp 临时 对 象 


// 使 用 getInputStream 作为 一 个 流 处 理 


在 实现 具体 连接 时 ， 在 Android 平台 中 使 用 了 Java 标准 的 输入 、 输 出 流 来 操作 实现 ， 


BluetoothSocket 提供 的 getInputStream() 和 getOutputStream() 方 法 可 以 很 好 地 处 理 具体 的 


到 此 为 止 ， 在 本 书 中 我 们 介绍 了 Android 中 和 蓝牙 应 


了 相关 的 两 个 类 的 用 法 。 至 于 其 


他 的 类 ， 也 都 是 基于 方法 实现 的 ， 为 节省 篇 幅 ， 不 再 一 一 进行 详解 。 
7.4.8 在 Android 平 台 开 发 蓝牙 应 用 的 基本 步骤 


经 过 前 面 的 学 习 ， 了 解 了 在 Android 系统 中 和 蓝牙 相关 的 API 类 。 其 实 从 查找 蓝牙 设备 


到 能 够 相互 通信 要 经 过 几 个 基本 步骤， 这 几 个 步骤 缺 一 不 可 。 各 个 步骤 的 具体 说 明 如 下 。 
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1 设置 权限 
在 文件 AndroidManifest xml 中 声明 蓝牙 权限 。 例 如 下 面 的 代码 


<uses-permission android:name="android.permission.BLUETOOTH"/> 
<uses-permission android:name="android.permission.BLUETOOTH ADMIN"/> 


2. 启动 蓝牙 


首先 要 查看 本 机 是 否 支 持 蓝 牙 ， 然 后 获取 BluetoothAdapter 蓝牙 适配器 对 象 。 例 如 下 
面 的 代码 : 


BluetoothAdapter mBluetoothAdapter = 
BluetoothAdapter.getDefaultAdapter(); 
if(mBluetoothAdapter == null)( 
// 表 明 此 手机 不 支持 蓝牙 
return; 
} 
if(!mBluetoothAdapter.isEnabled())( // 蓝 牙 未 开启 ， 则 开启 蓝牙 
Intent enableIntent = new Intent 
(BluetoothAdapter.ACTION REQUEST ENABLE); 
startActivityForResult(enableIntent, REQUEST ENABLE BT); 
) 
Miles 
public void onActivityResult (int requestCode, int resultCode, Intent data) { 
if (requestCode == REQUEST ENABLE BT) { 
if (requestCode == RESULT OK) { 
// 蓝 牙 已 经 开启 
f; 


) 


3. 发 现 蓝 牙 设 备 


(1) 使 本 机 蓝牙 处 于 可 见 ( 即 处 于 易 被 搜索 到 的 状态 )， 便 于 其 他 设备 发 现 本 机 蓝牙 。 演 
示 代 码 如 下 : 
// 使 本 机 蓝牙 在 300 秒 内 可 被 搜索 
private void ensureDiscoverable() ( 
if (mBluetoothAdapter.getScanMode() != 
BluetoothAdapter.SCAN MODE CONNECTABLE DISCOVERABLE) ( 
Intent discoverableIntent = new Intent 
(BluetoothAdapter.ACTION REQUEST DISCOVERABLE); 
discoverableIntent.putExtra (BluetoothAdapter. 
EXTRA DISCOVERABLE DURATION, 300); 
startActivity (discoverableIntent); 


} 
(2) 查找 已 经 配对 的 蓝牙 设备 ， 即 以 前 已 经 配对 过 的 设备 。 演 示 代 码 如 下 : 


Set«BluetoothDevice» pairedDevices = mBluetoothAdapter.getBondedDevices () ; 
if (pairedDevices.size() > 0) { 
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findViewById(R.id.title paired devices) .setVisibility (View.VISIBLE) ; 
for (BluetoothDevice device : pairedDevices) { 
//device.getName() +" "+ device.getAddress()); 


} 
} else ( 


mPairedDevicesArrayAdapter.add ("没有 找到 已 匹配 的 设备 "); 
} 


(3) 通过 mBluetoothAdapter.startDiscovery() 来 搜索 设备 ， 在 此 需要 注册 一 个 
BroadcastReceiver 来 获得 这 个 搜索 结果 。 即 先 注册 再 获取 信息 ， 然 后 进行 处 理 。 演 示 代 码 
如 下 : 


// 注 册 ， 当 一 个 设备 被 发 现时 调用 onReceive 
IntentFilter filter = new IntentFilter(BluetoothDevice.ACTION FOUND); 
this.registerReceiver (mReceiver, filter); 
// 当 搜索 结束 后 调用 onReceive 
filter = new IntentFilter(BluetoothAdapter.ACTION DISCOVERY FINISHED); 
this.registerReceiver (mReceiver, filter); 
ifs 
private BroadcastReceiver mReceiver = new BroadcastReceiver() { 
@override 
public void onReceive(Context context, Intent intent) { 
String action = intent.getAction(); 
if (BluetoothDevice.ACTION FOUND.equals (action) ) { 
BluetoothDevice device = intent.getParcelableExtra 
(BluetoothDevice.EXTRA DEVICE) ; 
// 已 经 配对 的 则 跳 过 
if (device.getBondState() != BluetoothDevice.BOND BONDED) 


mNewDevicesArrayAdapter.add(device.getName() + "An" + 
device.getAddress()); // 保 存 设备 地 址 与 名 字 
} 
}else if (BluetoothAdapter.ACTION DISCOVERY FINISHED. 
equals(action)) ( // 搜 索 结束 
if (mNewDevicesArrayAdapter.getCount() == 0) { 
mNewDevicesArrayAdapter.add ("没有 搜索 到 设备 ") ; 
} 
} 


te 


4. 建立 连接 


当 查 找到 蓝牙 设备 后 ， 接 下 来 需要 建立 本 机 与 其 他 设备 之 间 的 连接 。 一 般 在 使 用 本 机 
搜索 其 他 蓝牙 设备 时 ， 本 机 可 以 作为 一 个 服务 器 端 来 接收 其 他 设备 的 连接 。 启 动 一 个 服务 
器 端的 线程 ， 循 环 等 待 客户 端的 连接 ， 这 与 ServerSocket 极为 相似 ， 此 线程 在 准备 连接 之 
前 启动 。 演 示 代码 如 下 : 

/ /UUID 可 以 看 作 一 个 端口 号 


private static final UUID MY UUID = 
UUID. fromString ("fa87c0d0-afac-llde-8a39-0800200c9a66"); 
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// 像 一 个 服务 器 一 样 时 刻 监听 是 否 有 连接 建立 
private class AcceptThread extends Thread( 
private BluetoothServerSocket serverSocket; 


public AcceptThread (boolean secure) { 
BluetoothServerSocket temp = null; 
Ery i 
temp = mBluetoothAdapter.listenUsingRfcommWithServiceRecord( 
NAME INSECURE, MY UUID); 
} catch (IOException e) { 
Log.e("app", "listen() failed", e); 
} 
serverSocket = temp; 
} 


public void run(){ 
BluetoothSocket socket=null; 
while (true) { 
try { 
socket = serverSocket.accept (); 
} catch (IOException e) { 
Log.e("app", "accept() failed", e); 
break; 
} 
} 
if (socket !=nu11) { 
// 此 时 可 以 新 建 一 个 数据 交换 线程 ， 把 此 Socket 传 进去 
) 
) 


// 取 消 监听 
public void cancel()( 
try ( 
serverSocket.close(); 
) catch (IOException e) ( 


Log.e("app", "Socket Type" + socketType + "close() of 
server failed", e); 


} 
} 
} 


5. 交换 数据 


当 搜 索 到 蓝牙 设备 后 ， 接 下 来 可 以 获取 设备 的 地 址 ， 通 过 此 地 址 获取 一 个 BluetoothDeviced 
对 象 ， 可 以 将 其 看 作 是 一 个 客户 端 ， 通 过 对 象 device.createRfcommSocketToServiceRecord 
(MY _UUID) 和 一 个 UUD 可 与 服务 器 建立 连接 ， 获 取 另 一 个 Socket 对 象 。 因 为 此 服务 器 
端 与 客户 端 各 有 一 个 Socket 对 象 ， 所 以 此 时 它们 可 以 互相 交换 数据 了 。 演 示 代 码 如 下 : 

// 另 一 个 设备 去 连接 本 机 ， 相 当 于 客户 端 


private class ConnectThread extends Thread( 
private BluetoothSocket socket; 
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private BluetoothDevice device; 
public ConnectThread (BluetoothDevice device,boolean secure) { 
this.device = device; 
BluetoothSocket tmp - null; 
try ( 
tmp = device.createRfcommSocketToServiceRecord(MY UUID SECURE); 
) catch (IOException e) ( 
Log.e("app", "create() failed", e); 


public void run()( 
mBluetoothAdapter.cancelDiscovery();  // 取 消 设备 查找 
try ( 
socket.connect (); 
} catch (IOException e) { 
try ( 
socket.close(); 
} catch (IOException el) { 
Log.e("app", "unable to close() "+ 
" socket during connection failure", el); 
) 
connetionFailed(); // 连 接 失败 
return; 


} 
// 此 时 可 以 新 建 一 个 数据 交换 线程 ， 把 此 Socket 传 进去 


public void cancel() { 
try ( 
socket.close(); 
} catch (IOException e) { 
Log.e("app", "close() of connect socket failed", e); 


6. 建立 数据 通信 线程 

此 阶段 的 任务 是 读 取 数 据 。 演 示 代码 如 下 : 

// 建 立 连接 后 ， 进 行 数据 通信 的 线程 
private class ConnectedThread extends Thread( 
private BluetoothSocket socket; 


private InputStream inStream; 
private OutputStream outStream; 


public ConnectedThread (BluetoothSocket socket) { 


this.socket = socket; 
try ( 
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// 获 得 输入 输出 流 


inStream = socket.getInputStream(); 
outStream = socket.getOutputStream(); 


) catch (IOException e) ( 
Log.e("app", "temp sockets not created", e); 


} 
} 


public void run() { 
byte[] buff = new byte[1024]; 
int len=0; 
// 读 数据 需 不 断 监 听 ， 写 不 需要 
while (true) { 


sS 
len = inStream.read (buff); 


// 把 读 取 到 的 数据 发 送 给 UI 进行 显示 
Message msg = handler.obtainMessage 
(BluetoothChat.MESSAGE READ, len, -1, buff); 
msg.sendToTarget (); 
) catch (IOException e) ( 
Log.e("app", "disconnected", e); 
connectionLost(); // 失 去 连接 
start(); // 重 新 启动 服务 器 
break; 
) 


public void write(byte[] buffer) ( 
try ( 
outStream.write (buffer); 
handler.obtainMessage (BluetoothChat.MESSAGE WRITE, -1, -1, buffer) 


.sendToTarget () ; 
) catch (IOException e) ( 
Log.e("app", "Exception during write", e); 
} 


) 
public void cancel() ( 
try ( 
Socket.close(); 


) catch (IOException e) ( 
Log.e("app", "close() of connect socket failed", e); 


) 
到 此 为 止 ， 一 个 基本 的 蓝牙 通信 操作 已 经 全 部 完成 。 读 者 在 开发 此 类 项 目 时 ， 只 需 按 
照 上 述 流程 进行 即 可 。 
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LI NR- Ts 


开发 蓝牙 项 目 是 一 件 很 麻烦 的 事情 ， 这 里 说 的 麻烦 不 仅仅 是 类 多 、 函 数 多 ， 而 且 在 测 
试 时 不 能 用 模拟 器 来 实现 ， 我 们 需要 真 机 ， 并 且 是 两 部 具有 蓝牙 模块 的 设备 。 笔 者 为 了 节 
省 成 本 ， 在 淘宝 网 上 网 购 了 一 个 蓝牙 模块 ， 开 始 了 我 们 的 这 个 实例 之 旅 。 


s 例 m 能 源码 路 径 | 
实例 7-1 通过 蓝牙 天 控 指挥 玩具 车 下 载 路 径 :\daima\7\lanya | 


(1) 将 网 购 的 蓝牙 模块 放 在 一 辆 玩具 车 上 ， 并 为 其 接 通 电源 。 

(2) 打开 Eclipse 新 建 一 个 Android 工程 文件 。 

(3) 编写 布局 文件 main.xml。 在 其 中 插入 5 个 控制 按钮 ， 分 别 实现 对 玩具 车 的 向 前 、 
左 转 、 右 转 、 后 退 和 停止 的 控制 。 具 体 代码 如 下 : 


<?xml version-"1.0" encoding="utf-8"?> 
«AbsoluteLayout 

android: id="@+id/widgeto" 
android:layout width="fill parent” 
android:layout height="fill parent" 
xmlns:android-"http://schemas.android.com/apk/res/android" 
> 

<Button 

android: id="@+id/btnF" 
android:layout width="100px" 
android:layout height="60px" 
android:text=" 向 前 " 

android:layout x-"130px" 
android:layout y-"62px" 

> 

</Button> 

<Button 

android: id="@+id/btnL" 
android:layout width="100px" 
android:layout height="60px" 
android:text=" 左 转 " 

android:layout x="20px" 
android:layout y="152px" 

> 

</Button> 

<Button 

android:id="@+id/btnR" 
android:layout width="100px" 
android:layout height="60px" 
android:text-"fif£" 

android:layout x-"240px" 
android:layout y-"152px" 
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= 

</Button> 

<Button 
android:id="@+id/btnB” 
android: layout_width="100px" 
android:layout height="60px" 
android: text="JaiE" 
android:layout x="130px" 


android:layout y="242px" 
> 

</Button> 

<Button 

android: id="@+id/btns" 


android:layout width="100px" 
android:layout height="60px" 
android: text="#1k" 


android: layout 130px" 
android:layout y="152px" 
> 

</Button> 
</AbsoluteLayout> 


(4) 编写 蓝牙 程序 控制 文件 lanyajava。 其 实现 原理 和 7.4 节 中 讲解 的 步骤 一 致 。 具 体 
实现 流程 如 下 。 
® 定义 类 lanya， 然 后 设置 $ 个 按钮 对 象 。 具 体 代码 如 下 : 


public class lanya extends Activity { 
private static final String TAG = "THINBTCLIENT"; 
private static final boolean D = true; 
private BluetoothAdapter mBluetoothAdapter = null; 
private BluetoothSocket btSocket = null; 


private OutputStream outStream = null; 
Button mButtonF; 
Button mButtonB; 
Button mButtonL; 
Button mButtonR; 
Button mButtons; 


@ 赋值 蓝牙 设备 上 的 标准 串 行 和 要 连接 的 蓝牙 设备 MAC 地 址 ， 具 体 代码 如 下 : 


private static final UUID MY UUID = UUID.fromString("00011101-0000- 
1000-807-00805F9B34FB") ;// 蓝 牙 设备 上 的 标准 串 行 

private static String address = "00:11:03:21:00:42"; // <== 要 连接 的 蓝牙 
设备 MAC 地 址 


C 编写 单 击 “ 向 前 ”按钮 的 处 理事 件 。 具 体 代码 如 下 : 


@override 
public void onCreate (Bundle savedInstanceState) { 
super .onCreate (savedInstanceState) ; 


setContentView(R.layout.main) ; 
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// 向 前 
mButtonF- (Button) findViewById (R.id.btnF); 
mButtonF.setOnTouchListener (new Button.OnTouchListener () { 


@override 
public boolean onTouch(View v, MotionEvent event) { 
// TODO Auto-generated method stub 
String message; 
byte[] msgBuffer; 
int action = event.getAction(); 
switch (action) 
{ 
case MotionEvent.ACTION DOWN: 
try ( 
outStream = btSocket.getOutputStream(); 
) catch (IOException e) ( 
Log.e(TAG, "ON RESUME: Output stream creation 
failed.", e); 
) 


message - "1"; 
msgBuffer = message.getBytes(); 
try ( 


outStream.write (msgBuffer); 
) catch (IOException e) ( 
Log.e(TAG, "ON RESUME: Exception during write.", e); 
) 
break; 
case MotionEvent.ACTION UP: 
try ( 
outStream - btSocket.getOutputStream(); 
) catch (IOException e) ( 
Log.e(TAG, "ON RESUME: Output stream creation 
failed.", e); 
) 
message = "0"; 
msgBuffer = message.getBytes(); 
try { 
outStream. write (msgBuffer) ; 
) catch (IOException e) { 
Log.e(TAG, "ON RESUME: Exception during 
write.", e); 
) 
break; 


} 
return false; 


he 
© 编写 单 击 “ 后 退 ” 按 钮 的 处 理事 件 ， 具 体 代码 如 下 : 


mButtonB- (Button) findViewById (R.id.btnB); 
mButtonB.setOnTouchListener (new Button.OnTouchListener () { 
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@override 
public boolean onTouch(View v, MotionEvent event) { 

// TODO Auto-generated method stub 

String message; 

byte[] msgBuffer; 

int action = event.getAction(); 

switch (action) 

{ 

case MotionEvent.ACTION DOWN: 

try ( 

outStream = btSocket.getOutputStream() ; 

} catch (IOException e) { 

Log.e(TAG, "ON RESUME: Output stream creation 
failed.", e); 


} 


message = "3"; 
msgBuffer = message.getBytes(); 
try í 


outStream.write (msgBuffer); 
} catch (IOException e) { 
Log.e(TAG, "ON RESUME: Exception during write.", e); 
} 
break; 


case MotionEvent.ACTION UP: 

try ( 

outStream = btSocket.getOutputStream(); 

) catch (IOException e) ( 

Log.e(TAG, "ON RESUME: Output stream creation 
failed.", e); 

) 
message - "0"; 
msgBuffer - message.getBytes(); 
try ( 

outStream.write (msgBuffer); 

) catch (IOException e) ( 

Log.e(TAG, "ON RESUME: Exception during 
write.", e); 
) 
break; 


return false; 


“ 左 转 ”按钮 的 处 理事 件 。 具 体 代码 如 下 : 


mButtonL- (Button) findViewById (R.id.btnL); 
mButtonL.setOnTouchListener (new Button.OnTouchListener () { 
@override 
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public boolean onTouch (View v, MotionEvent event) ( 
// TODO Auto-generated method stub 
String message; 
byte[] msgBuffer; 
int action = event.getAction(); 
Switch (action) 
{ 
case MotionEvent.ACTION DOWN: 
Ery g 
outStream = btSocket.getOutputStream(); 
) catch (IOException e) ( 
Log.e(TAG, "ON RESUME: Output stream creation 
failed.", e); 
) 


message - "2"; 
msgBuffer = message.getBytes(); 
try { 


outStream.write (msgBuffer); 
) catch (IOException e) ( 
Log.e(TAG, "ON RESUME: Exception during write.", e); 
) 
break; 


case MotionEvent.ACTION UP: 
try ( 
outStream - btSocket.getOutputStream(); 
) catch (IOException e) ( 
Log.e(TAG, "ON RESUME: Output stream creation 
failed.", e); 
) 
message - "0"; 
msgBuffer - message.getBytes(); 
try ( 
outStream.write (msgBuffer); 
) catch (IOException e) ( 
Log.e(TAG, "ON RESUME: Exception during 
write.", e); 
} 
break; 


return false; 


n; 
© 编写 单 击 “ 右 转 ” 按 钮 的 处 理事 件 。 有 具体 代码 如 下 : 


mButtonR- (Button) findViewById (R.id.btnR); 
mButtonR.setOnTouchListener (new Button.OnTouchListener () { 
@override 
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public boolean onTouch(View v, MotionEvent event) ( 
// TODO Auto-generated method stub 
String message; 
byte[] msgBuffer; 
int action = event.getAction(); 
switch (action) 
{ 
case MotionEvent.ACTION DOWN: 
Ey 
outStream = btSocket.getOutputStream(); 
) catch (IOException e) ( 
Log.e(TAG, "ON RESUME: Output stream creation 
failed.", e); 


} 


message = "4"; 
msgBuffer = message.getBytes(); 
try ( 


outStream.write (msgBuffer); 
) catch (IOException e) ( 
Log.e(TAG, "ON RESUME: Exception during write.", e); 
) 
break; 


case MotionEvent.ACTION UP: 
try ( 
outStream - btSocket.getOutputStream(); 
) catch (IOException e) ( 
Log.e(TAG, "ON RESUME: Output stream creation 
failed.", e); 
) 
message - "0"; 
msgBuffer - message.getBytes(); 
try ( 
outStream.write (msgBuffer); 
) catch (IOException e) ( 
Log.e(TAG, "ON RESUME: Exception during 
write.", e); 
} 
break; 


return false; 


he 
全“ 停止 ”按钮 的 处 理事 件 。 有 具体 代码 如 下 : 


mButtons= (Button) findViewById (R.id.btnS); 
mButtonS.setOnTouchListener (new Button.OnTouchListener (){ 
@override 
public boolean onTouch(View v, MotionEvent event) { 


0B 72 #4 Android 中 开发 蓝牙 应 用 


// TODO Auto-generated method stub 
if(event.getAction()--MotionEvent.ACTION DOWN) 
try ( 

outStream = btSocket.getOutputStream(); 

) catch (IOException e) ( 

Log.e(TAG, "ON RESUME: Output stream creation 
failed.", e); 

} 

String message = "0"; 

byte[] msgBuffer = message.getBytes(); 

try { 

outstream.write (msgBuffer); 

} catch (IOException e) { 

Log.e(TAG, "ON RESUME: Exception during 
write.", e); 

) 

return false; 


he 
if (D) 
Log.e(TAG, "+++ ON CREATE +++"); 
mBluetoothAdapter = BluetoothAdapter.getDefaultAdapter(); 
if (mBluetoothAdapter == null) { 
Toast.makeText (this，" 蓝 牙 设 备 不 可 用 ， 请 打开 蓝牙 ! ", 
Toast.LENGTH LONG).show(); 
finish(); 
return; 
} 
if (!mBluetoothAdapter.isEnabled()) { 
Toast.makeText (this, "请 打开 蓝牙 并 重新 运行 程序 ! ", 
Toast.LENGTH LONG) .show() 
finish(); 
return; 
$ 
if (D) 
Log.e(TAG, "+++ DONE IN ON CREATE, GOT LOCAL BT ADAPTER +++"); 
E 


通过 套 接 字 建 立 蓝牙 连接 ， 如 果 失 败 则 输出 失败 提示 。 主 要 代码 如 下 : 


@override 
public void onStart() { 
super.onStart(); 
if (D) Log.e(TAG, "++ ON START ++"); 
} 
@Override 
public void onResume() { 
super.onResume () ; 
i£ (D) { 
Log.e(TAG, "+ ON RESUME +"); 
Log.e(TAG, "+ ABOUT TO ATTEMPT CLIENT CONNECT +"); 
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DisplayToast (" 正 在 尝试 连接 智能 小 车 ， 请 稍 后 。。“。“。") ; 
BluetoothDevice device = mBluetoothAdapter.getRemoteDevice (address); 
try ( 

btSocket = device.createRfcommSocketToServiceRecord (MY UUID) g 
) catch (IOException e) ( 

DisplayToast (" 套 接 字 创建 失败 ! ") ; 
DisplayToast ("成 功 连接 智能 小 车 ! 可 以 开始 操控 了 ~~~"); 
mBluetoothAdapter.cancelDiscovery(); 
try ( 
btSocket.connect (); 


DisplayToast (" 连 接 成 功 建立 ， 数 据 连接 打开 ! "); 


) catch (IOException e) ( 
try ( 
btSocket.close(); 
) catch (IOException e2) ( 


DisplayToast (" 连 接 没有 建立 ， 无 法 关闭 套 接 字 ! n); 


} 
aie 1D) 
Log.e(TAG, "+ ABOUT TO SAY SOMETHING TO SERVER +"); 
) 
@override 
public void onPause() { 
super.onPause(); 
1E DY 
Log.e(TAG, "- ON PAUSE -"); 
if (outStream !- null) ( 
try ( 
outStream.flush(); 
) catch (IOException e) ( 
Log.e(TAG, "ON PAUSE: Couldn't flush output 
stream.", e); 


} 
try { 
btSocket.close(); 
} catch (IOException e2) { 


DisplayToast (" 套 接 字 关闭 失败 ! ") ; 


} 
@override 
public void onStop() { 
super.onStop(); 
if (D)Log.e(TAG, "—- ON STOP —--"); 
H 
@override 
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public void onDestroy() { 
super.onDestroy(); 
if (D) Log.e(TAG, "—-- ON DESTROY ——-"); 

f 

public void DisplayToast (String str) 

{ 

Toast toast-Toast.makeText(this, str, Toast.LENGTH LONG); 

toast.setGravity(Gravity.TOP, 0, 220); 

toast.show(); 

H 

) 


(5) 在 文件 AndroidManifest.xml 中 声明 蓝牙 权限 ， 对 应 代码 如 下 : 


«uses-permission android:name-"android.permission.BLUETOOTH ADMIN" /> 
«uses-permission android:name-"android.permission.BLUETOOTH" /> 
«application android:icon-"8drawable/icon" android:label- 
"Qstring/app name"> 
«activity android:name-".lanya" 
android: label="@string/app name"> 
<intent-filter> 
«action android:name-"android.intent.action.MAIN" /> 
«category android:name-"android.intent.category.LAUNCHER" /> 
«/intent-filter» 
</activity> 


到 此 为 止 ， 我 们 的 蓝牙 控制 玩具 车 的 实例 就 介绍 完毕 了 。 本 实例 的 实现 比较 简单 ， 难 
度 大 的 是 双向 控制 ， 即 实现 每 个 设备 都 可 以 操控 另外 一 个 设备 的 功能 ， 此 时 需要 有 蓝牙 功 
能 的 电脑 或 Android 手机 来 完成 测试 了 。 在 模拟 器 中 因为 不 具备 蓝牙 设备 ， 程 序 执行 后 会 
显示 “蓝牙 设备 不 可 用 ， 请 打开 蓝牙 ! ”的 提示 ， 如 图 7-3 所 示 。 


蓝牙 设备 不 可 用 ， 请 打开 蓝牙 ! 


7-3 ”模拟 器 的 运行 效果 
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在 Androi0 中 和 开发 Wi-Fi 应 用 


Wi-Fi 是 一 种 可 以 将 个 人 电脑 、 手 持 设备 (如 PDA、 手 机 ) 
等 终端 以 无 线 方式 互相 连接 的 技术 。Wi-Fi 是 一 个 无 线 网 路 通 
信 技 术 的 品牌 ， 由 Wi-Fi 联盟 (Wi-Fi Alliance) 所 持 有 。 目 的 是 
改善 基于 IEEE 802.11 标准 的 无 线 网 路 产品 之 间 的 互通 性 。 现 
在 一 般 人 会 把 Wi-Fi 及 IEEE 802.11 混为一谈 。 甚 至 直接 把 
Wi-Fi 等 同 于 无 线 网 际 网 路 。 本 章 将 简要 介绍 在 Android 平台 中 
开发 Wi-Fi 相关 应 用 的 基本 知识 。 
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8.1] 7# Wi-Fi 系统 的 结构 


Wi-Fi 系统 比较 复杂 ， 但 是 却 比 较 常用 ， 要 想 完全 掌握 Wi-Fi 应 用 开发 技术 ， 我 们 需 
要 从 底层 做 起 ， 需 要 先 了 解 它 的 底层 结构 。 本 节 将 简要 讲解 Wi-Fi 系统 底层 结构 的 基本 
知识 。 


8.1.1 Wi-Fi 概 述 


在 Android 系统 中 ， 存 在 一 个 无 线 控 制 模块 。 打 开 方 式 如 下 : 依次 选择 Menu | 
Settings | Wireless$networks | Wi-Fi settings 命令 ， 打 开 如 图 8-1 所 示 的 界面 。 


Wi-Fi settings 


Wi-Fi 


old donna 


图 8-1 ”Wi-Fi 控制 界面 
8.1.2 ”Wi-Fi 层次 结构 


Wi-Fi 系统 的 上 层 接口 包括 数据 部 分 和 控制 部 分 。 数 据 部 分 通常 是 一 个 和 以 太 网 卡 类 
似 的 网 络 设备 ， 控 制 部 分 用 于 实现 接 入 点 操作 和 安全 验证 处 理 。 

在 软件 层 ，Wi-Fi 系统 包括 Linux 内 核 程 序 和 协议 ， 还 包括 本 地 部 分 、Java 框架 类 。 
Wi-Fi 系统 向 Java 应 用 程序 层 提供 了 控制 类 的 接口 。 

Android 平台 中 Wi-Fi 系统 的 基本 层次 结构 如 图 8-2 所 示 。 

由 图 8-2 可 知 ，Android 平台 中 Wi-Fi 系统 从 上 到 下 主要 包括 Java 框架 类 、Android 适 
配器 库 、wpa_supplicant 守护 进程 、 驱 动 程序 和 协议 ， 这 几 部 分 的 系统 结构 如 图 8-3 所 示 。 
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Wi-Fi 系 统 的 管理 类 


EHH 
图 8-2 ”Wi-Fi 系统 的 ABE 


Android.net.wifi 
Java 应 用 层 Settings、Wifitcher 等 
Java 框 架 层 Android.net.wifi 包 E 
aig JNI、Wi-Fi 适 配器 ， 
EUER wpa supplicant 
WPA 适 配器 层 
配置 文件 
数据 * re wpa supplicant.conf 
通道 i 
wpa_supplicant 守 护 进程 上- 
一 一 -一 一 mmm] Wi-Fi 设 备 
CERE WLAN 网 络 设备 J 驱动 | 驱动 | 驱动 
内 核 空间 层 < 


Wi-Ei 协 议 


| Wi-Fi 特 定 驱动 


8-3 ”Wi-Fi 的 系统 结构 


图 8-3 中 各 个 部 分 的 具体 说 明 如 下 。 
(1) Wi-Fi 用 户 空间 的 程序 和 库 ， 对 应 路 径 如 下 : 


external/wpa supplicant/ 
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在 此 生成 库 libwpaclient.so 和 守护 进程 wpa_supplicant。 
(2) Wi-Fi 管理 库 ， 即 适配器 库 ， 通 过 调用 库 libwpaclient.so 成 为 wpa_supplicant 在 
Android 中 的 客户 端 。 对 应 路 径 如 下 : 


hardware/libhardware legary/wifi/ 

(3) INI 部 分 的 对 应 路 径 如 下 : 
frameworks/base/core/jni/android net wifi Wifi.cpp 
(4) Java 框架 部 分 的 对 应 路 径 如 下 : 


frameworks/base/services/java/com/android/server/ 
frameworks/base/wifi/java/android/net/wifi/ 


在 android.net.wifi 将 作为 Android 平台 的 API 供 Java 应 用 程序 层 使 用 。 
(5) Wi-Fi Settings 应 用 程序 的 对 应 路 径 如 下 : 


packages/apps/Settings/src/com/android/settings/wifi/ 


8.1.3 ”Wi-Fi 在 Android 和 Linux 中 的 差异 


我 们 先 看 Wi-Fi 在 Android 中 是 如 何 工作 的 :Android 使 用 一 个 修改 版 wpa_supplicant 
作为 daemon 来 控制 Wi-Fi， 代 码 位 于 如 下 目录 中 。 
external/wpa supplicant 


wpa_supplicant 是 通过 socket 与 文件 hardware/libhardware legacy/wifi/wifi.c 进行 通 
信 。UI 通过 android.net.wifi package(frameworks/base/wifi/java/android/net/wifi/) 43 tit SHY 
文件 wifi.c。 相 应 的 INI 实现 位 于 文件 frameworks/base/core/jni/android net wifi Wifi.cpp 
中 ， 更 高 一 级 的 网 络 管理 位 于 如 下 目录 中 。 

frameworks/base/core/java/android/net 


TE Android 中 的 无 线 局 域 网 部 分 是 标准 的 系统 ， 并 且 针 对 特定 的 硬件 平台 ， 所 以 需要 
移植 和 改动 的 内 容 并 不 多 。 在 Linux APA Wi-Fi 的 标准 协议 ， 不 同 硬件 平台 的 差异 仅 
仅 体 现在 Wi-Fi 芯片 驱动 程序 。 除 了 这 些 芯片 级 驱动 的 差异 外 ， 在 Android 中 实现 其 他 无 
线 局 域 网 部 分 的 方法 在 Linux 内 核 中 已 经 给 出 了 具体 方法 。 

而 在 Android 用 户 空间 中 ， 使 用 了 标准 的 wpa_supplicant 守护 进程 ， 这 也 是 一 个 标准 
的 实现 ， 所 以 无 须 我 们 为 Wi-Fi 增加 单独 的 硬件 抽象 层 代 码 ， 只 需 进 行 简 单 的 配置 工作 
即 可 。 


8.2 分 析 Wi-Fi RH 


要 想 掌握 Wi-Fi 的 开发 原理 ， 我 们 需要 分 析 Android 中 的 Wi-Fi 源码 并 了 解 其 核心 构 
造 ， 这 样 才能 对 Wi-Fi 应 用 开发 做 到 游 轧 有余。 本 节 将 简要 介绍 开源 Android 中 和 Wi-Fi 
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相关 的 代码 。 


8.2.1 本 地 部 分 


本 地 实现 部 分 主要 包括 wpa_supplicant 以 及 wpa_supplicant 适 配 层 。WPA 是 Wi-Fi 
Protected Access 的 缩写 ， 中 文 含义 为 “WiFi 网 络 安全 存 取 ”。WPA 是 一 种 基于 标准 的 
可 互 操 作 的 WLAN 安全 性 增强 解决 方案 ， 可 大 大 增强 现 有 以 及 未 来 无 线 局 域 网 系统 的 数 
据 保护 和 访问 控制 水 平 。 

wpa_supplicant 适 配 层 是 通用 的 wpa_supplicant 的 封装 ， 在 Android 中 作为 Wi-Fi 部 分 
的 硬件 抽象 层 来 使 用 。wpa_supplicant 适 配 层 主要 用 于 封装 与 wpa_supplicant 守护 进程 的 
通信 ， 以 提供 给 Android 框架 使 用 。 它 实现 了 加 载 、 控 制 和 消息 监控 等 功能 。 
wpa_supplicant 适 配 层 的 头 文件 如 下 : 


hardware/libhardware legacy/include/hardware legacy/wifi.h 


wpa_supplicant 的 标准 结构 框图 如 图 8-4 所 示 。 


wpa cli GUI frontend | 


fronténd control inteyface 


wpa_supplicant 


-— 
ctrl if 


WPA/WPA2 


state machine 


crypto TLS 


configuration 


EAPOL and | ES 
re-auth | F om BAFOL 
pari 12_packet o state machine 
from/to kernel EAP methods 


EAP-TLS EAP-MD5 


EAP 
state machine 


driver events [— — | EAP-PEAP || EAP-TTLS 


EAP-GTC EAP-OTP. 


EAP-SIM EAP-AKA 


EAP-PSK LEAP 


EAP-PAX EAP-FAST 


wext hostap || madwifi || hermes — ||atmel ndiswrapper FAP-MSCHAPv2 


kernel network device driver 


wpa_supplicant modules 
图 8-4 wpa_supplicant 的 标准 结构 框图 
我 们 重点 关注 框图 的 下 半 部 分 ， 即 wpa_supplicant 是 如 何 与 Driver 进行 联系 的 。 假 设 
整个 过 程 以 AP 发 出 SCAN 命令 为 主线 。 由 于 现在 大 部 分 Wi-Fi Driver 都 支持 wext， 所 以 


就 假设 我 们 的 设备 走 的 是 wext 这 条 线 ， 其 实用 ndis 也 一 样 ， 整 个 流程 也 差不多 。 
首先 要 说 的 是 ， 在 文件 Driverh 文件 中 存在 一 个 名 为 wpa_driver_ops 的 结构 体 ， 这 个 
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结构 体 在 Driver.c 中 被 声明 如 下 : 


#ifdef CONFIG DRIVER WEXT 
extern struct wpa driver ops wpa driver wext ops; 


然后 在 文件 driver_wext.c 中 添加 了 该 结构 体 的 成 员 ， 代 码 如 下 : 


const struct wpa driver ops wpa driver wext ops = { 
.name = "wext", 
-desc = "Linux wireless extensions (generic)", 
-get bssid = wpa driver wext get bssid, 
-get ssid = wpa driver wext get ssid, 
.Set wpa = wpa driver wext set wpa, 
.Set key = wpa driver wext set key, 
.Set countermeasures = wpa driver wext set countermeasures, 
.Set drop unencrypted = wpa driver wext set drop unencrypted, 
.Scan = wpa driver wext scan, 
.Combo scan = wpa driver wext combo scan, 
-get scan results2 = wpa driver wext get scan results, 
-deauthenticate = wpa driver wext deauthenticate, 
-disassociate = wpa driver wext disassociate, 
.set mode = wpa driver wext set mode, 
.associate - wpa driver wext associate, 
.set auth alg - wpa driver wext set auth alg, 
.init - wpa driver wext init, 
.deinit = wpa driver wext deinit, 
.add pmkid = wpa driver wext add pmkid, 
.remove pmkid = wpa driver wext remove pmkid, 
.flush pmkid = wpa driver wext flush pmkid, 
.get capa - wpa driver wext get capa, 
.set operstate - wpa driver wext set operstate, 
#ifdef ANDROID 
.driver cmd - wpa driver priv driver cmd, 
#endif 
n 


上 述 成 员 其 实 都 是 驱动 和 wpa_supplicant 的 接口 。 以 SCAN 为 例 的 代码 如 下 : 

int wpa driver wext scan(void *priv, const u8 *ssid, size t ssid len) 

通过 如 下 代码 可 以 看 出 wpa_supplicant 是 通过 IOCTL 来 调用 SOCKET 与 DRIVER it 
行 通信 的 ， 并 给 DRIVER 下 达 SIOCSIWSCAN 命令 。 


if (ioctl(drv-»ioctl sock, SIOCSIWSCAN, &iwr) < 0) 


这 样 ， 当 一 个 命令 从 AP 到 Framework， 然 后 到 C++ 本 地 库 ， 再 到 wpa_supplicant 3& 
配 层 ， 最 后 wpa_supplicant 下 CMD 给 Driver 的 路 线 就 打通 了 。 
因为 Wi-Fi 模块 是 采用 SDIO 总 线 来 控制 的 ， 所 以 应 该 先 记 录 下 Client Driver 的 SDIO 
部 分 的 结构 。 此 部 分 的 SDIO 分 为 三 层 ， 分 别 是 SdioDrv、SdioAdapter 和 SdioBusDrv。 
中 SdioBusDrv 是 Client Driver 中 SDIO 与 Wi-Fi 模块 的 接口 ，SdioAdapter 是 SdioDrv 和 
SdioBusDrv 之 间 的 适 配 层 ，SdioDrv 是 Client Driver 中 SDIO 5j Linux Kernel 中 的 MMC 
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SDIO 的 接口 。 这 三 部 分 只 需要 关注 一 下 SdioDrv 就 可 以 了 ， 另 外 两 层 都 只 是 对 它 的 封装 。 
在 SdioDrv 中 提供 了 下 面 的 功能 。 


static struct sdio driver tiwlan sdio drv = { 
-probe = tiwlan sdio probe, 
.remove = tiwlan sdio remove, 
.name - "sdio tiwlan", 
.id table = tiwll2xx devices, 
n 
int sdioDrv EnableFunction (unsigned int uFunc) 
int sdioDrv EnableInterrupt (unsigned int uFunc) 


SDIO 的 读 写实 际 上 调用 了 MMC Core 中 的 如 下 功能 函数 : 
static int mmc io rw direct host() 


SDIO 功能 部 分 读者 只 需 简单 了 解 即 可 ， 一 般 host 部 分 芯片 厂商 都 会 提供 完整 的 解决 
方案 。 我 们 的 主要 任务 还 是 Wi-Fi 模块 。 

首先 来 看 WiFi 模块 的 入 口 函 数 wlanDrvIf Modulemit0) ， 在 此 调用 了 
wlanDrvIf Create0。 主 要 代码 如 下 : 


static int wlanDrvIf Create (void) 
{ 
TWlanDrvIfObj *drv; // 这 个 结构 体 为 代表 设备 ， 包 含 Linux 网 络 设备 结构 体 net device 
pDrvStaticHandle = drv; 
drv-»pWorkQueue - create singlethread workqueue (TIWLAN DRV NAME); 
// 创 建 了 工作 队列 
rc = wlanDrvIf SetupNetif (drv); 
drv-»wl sock = netlink kernel create( NETLINK USERSOCK, 0, NULL, NULL, 
THIS MODULE ); 
// Gilet T HEX wpa_supplicant 的 Socket 接口 
rc = drvMain Create (drv, 
&drv-»tCommon.hDrvMain, 
&drv-»tCommon.hCmdHndlr, 
&drv-»tCommon.hContext, 
&drv-»tCommon.hTxDataQ, 
&drv-»tCommon.hTxMgmtQ, 
&drv-»tCommon.hTxCtrl, 
&drv-»tCommon.hTWD, 
&drv-»tCommon.hEvHandler, 
&drv-»tCommon.hCmdDispatch, 
&drv-»tCommon.hReport, 
&drv-»tCommon.hPwrState); 
rc = hPlatform initInterrupt (drv, (void*)wlanDrvIf HandleInterrupt); 
return 0; 
} 


在 调用 完 wlanDrvIf_Create() 函 数 后 ， 实 际 上 Wi-Fi 模块 的 初始 化 就 结束 了 。 
下 面 分 析 是 如 何 初始 化 的 。 先 看 wlanDrvIf SetupNetif (drv) 函 数 的 主体 ， 对 应 代码 
如 下 : 
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static int wlanDrvIf SetupNetif (TWlanDrvIfObj *drv) 
t 
struct net device *dev; 
int res; 
dev = alloc etherdev (0); // 申 请 Linux 网 络 设备 
if (dev == NULL) 
ether setup (dev); // 建 立 网 络 接口 ， 这 两 个 都 是 Linux 网 络 设备 驱动 的 标准 函数 
dev-»netdev ops = &wlan netdev ops; 
wlanDrvWext Init (dev); 
res = register netdev (dev); 
hPlatform SetupPm(wlanDrvIf Suspend, wlanDrvIf Resume, pDrvStaticHandle); 


) 


在 此 初始 化 了 wlanDrvWext Init(dev)， 说 明 wpa_supplicant 与 Driver 直接 的 联系 是 走 
的 wext 这 条 路 。 也 就 是 说 event 的 接收 ， 处 理 也 应 该 是 在 wext 部 分 来 实现 的 。 确 定 此 论 
点 之 后 ， 剩 下 的 工作 量 立 刻 减 少 了 三 分 之 一 。 接 下 来 需要 注册 网 络 设备 dev， 在 
wlan netdev ops 中 的 定义 代码 如 下 : 


static const struct net device ops wlan netdev ops = ( 
.ndo open = wlanDrvIf Open, 
.ndo stop - wlanDrvIf Release, 
.ndo do ioctl - NULL, 
.ndo start xmit = wlanDrvIf Xmit, 
.ndo get stats = wlanDrvIf NetGetStat, 
.ndo validate addr - NULL, 


MF 


上 述 代码 名 字 对 应 的 都 是 Linux 网 络 设备 驱动 的 命令 字 ， 最 后 需要 调用 
“rc=drvMain_CreateI”， 通 过 此 函数 完成 相关 模块 的 初始 化 工作 。 


8.2.2 JNI 部 分 


Android 中 的 Wi-Fi 系统 的 INI 部 分 实现 的 源码 文件 如 下 : 

frameworks/base/core/jni/android net wifi Wifi.cpp 

JNI 层 的 接口 注册 到 Java 层 的 源 代码 文件 如 下 : 

frameworks/base/wifi/java/android/net/wifi/WifiNative.java 

WifiNative 将 为 WifiService, WifiStateTracker. WifiMonitor 等 几 个 Wi-Fi 框架 内 部 组 
件 提 供 底层 操作 支持 。 

此 处 实现 的 本 地 函数 都 是 通过 调用 wpa_supplicant 适 配 层 的 接口 来 实现 的 (包含 适 配 层 
的 头 文件 wifi.h)。wpa_supplicant 适 配 层 是 通用 的 wpa_supplicant 的 封装 ， 在 Android 中 作 
为 WiFi 部 分 的 硬件 抽象 层 来 使 用 。wpa_supplicant 适 配 层 主 要 用 于 封装 与 wpa_supplicant 
守护 进程 的 通信 ， 以 提供 给 Android 框架 使 用 。 它 实现 了 加 载 、 控 制 和 消息 监控 等 功能 。 
wpa_supplicant 适 配 层 的 头 文件 如 下 : 


hardware/libhardware legacy/include/hardware legacy/wifi.h 
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文件 wifih 是 Wi-Fi 适配器 层 对 INT 部 分 的 接口 ， 其 中 包含 了 一 些 加 载 和 连接 的 控制 
接口 ， 主 要 包括 如 下 两 个 接口 。 
口 wifi command(: 负责 将 命令 发 送 到 Wi-Fi 下 层 。 
Q wifi wait for event): 负责 事件 进入 通道 ， 此 函数 将 被 阻塞 ， 直 到 收 到 一 个 Wi- 
Fi 事件 为 止 ， 并 且 以 字符 串 的 形式 返回 。 
在 文件 wifi.h 中 定义 上 述 接口 的 代码 如 下 : 
int wifi command(const char *command, char *reply, size t *reply len); 
int wifi wait for event(char *buf, size t len); 
在 文件 wifi. 中 实现 了 上 述 两 个 接口 ， 具 体 代码 如 下 : 


int wifi command(const char *command, char *reply, size t *reply len) 
{ 


return wifi send command(ctrl conn, command, reply, reply len); 
) 
int wifi wait for event(char *buf, size t buflen) 
t 

size t nread - buflen - 1; 

int fd; 

fd set rfds; 

int result; 

struct timeval tval; 

struct timeval *tptr; 


if (monitor conn == NULL) 
return 0; 


result = wpa ctrl recv (monitor conn, buf, &nread); 
if (result < 0) ( 
LOGD("wpa ctrl recv failed: %s\n", strerror(errno)); 
return -1; 
lj 
buf[nread] = '\0'; 
if (result == 0 && nread == 0) { 
/* Fabricate an event to pass up */ 
LOGD("Received EOF on supplicant socket\n"); 
strncpy (buf, WPA EVENT TERMINATING " - signal 0 received", buflen-1); 
buf[buflen-1] = '\0'; 
return strlen (buf); 


if (buf[0] == '«') { 
char match = strchr(buf, '>'); 
if (match != NULL) ( 
nread -= (match-1l-buf); 
memmove (buf, match-1, nread+1); 


$ 
return nread; 


= Andicid assa num 


8.23 Java FrameWork 部 分 


Wi-Fi 系统 的 Java 部 分 代码 实现 的 目录 如 下 : 

frameworks/base/wifi/java/android/net/wifi/ // Wi-Fi 服务 层 的 内 容 

frameworks/base/services/java/com/android/server/  // Wi-Fi 部 分 的 接口 

Wi-Fi 系统 Java 层 的 核心 是 根据 IWifiManger 接口 所 创建 的 Binder 服务 器 端 和 客户 
端 ， 服 务 器 端 是 WifiService， 客 户 端 是 WifiManger. 

编译 TWifiManger.aidl 生成 文件 TWifiManger.java， 并 生成 TWifiManger.Stub( 服 务 器 端 
抽象 类 ) 和 IWifiManger.Stub.Proxy( 客 户 端 代理 实现 类 )。Wifiservice 通过 继承 
IWifiManger.Stub 实现 ， 而 客户 端 通过 getService() FA Be 4K HX IWifiManger.Stub.Proxy( 即 
Service 的 代理 类 )， 将 其 作为 参数 传递 给 WifiManger， 供 其 与 WifiService 通信 时 使 用 。 

具体 结构 如 图 8-5 所 示 。 


8-5 ”JNI 接 口 结构 


图 8-5 中 主要 构成 元 素 的 具体 说 明 如 下 。 

(1) WifiManger 是 Wi-Fi 部 分 与 外 界 的 接口 ， 用 户 通 过 它 来 访问 Wi-Fi 的 核心 功能 。 
WifiWatchdogService 系统 组 件 也 是 用 WifiManger 来 执行 一 些 具体 操作 。 

(2) WifiService 是 服务 器 端的 实现 ， 作 为 Wi-Fi 的 核心 ， 处 理 实际 的 驱动 加 载 、 扫 描 、 
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链接 、 断 开 等 命令 ， 以 及 底层 上 报 的 事件 。 对 于 主动 的 命令 控制 ，Wi-EFi 是 一 个 简单 的 封 
装 ， 针 对 来 自 客户 端的 控制 命令 ， 调 用 相应 的 WifiNative 底层 实现 。 
接收 到 客户 端的 命令 后 ， 一 般 会 将 其 转换 成 对 应 的 自身 消息 塞 入 消息 队列 中 ， 以 便 
客户 端的 调用 可 以 及 时 返回 ， 然 后 在 WifiHandler 的 handleMessage() 中 处 理 对 应 的 消息 。 
而 底层 上 报 的 事件 ，WifiService 则 通过 启动 WifiStateTracker 来 负责 处 理 。 
(3) WifiStateTracker 和 WifiMonitor 的 具体 功能 如 下 。 
O WifiStateTracker 除了 负责 Wi-Fi 的 电源 管理 模式 等 功能 外 ， 其 核心 是 WifiMonitor 
所 实现 的 事件 轮 询 机 制 ， 以 及 消息 处 理 函 数 handleMessage(). 
a WifiMonitor 通过 开启 一 个 MonitorThread 来 实现 事件 的 轮 询 ， 轮 询 的 关键 函数 是 
前 面 提 到 的 阻塞 式 函 数 WifiNative.waitForEvent()。 获 取 事 件 后 ，WifiMonitor 通 
过 一 系列 的 Handler 通知 给 WifiStateTracker。 这 里 WifiMonitor 的 通知 机 制 是 将 
底层 事件 转换 成 WifiStateTracker 所 能 识别 的 消息 ， 塞 入 WifiStateTracker 的 消息 
循环 中 ， 最 终 在 handleMessage() P H WifiStateTracker 完成 对 应 的 处 理 。 
WifiStateTracker 同样 是 Wi-Fi 部 分 与 外 界 的 接口 ， 它 不 像 WifiManger 那样 直接 被 实 
例 化 来 操作 ， 而 是 通过 Intent 机 制 来 发 消息 通知 给 客户 端 注册 的 BroadcastReceiver， 以 完 
成 和 客户 端的 接口 。 

(4) WifiWatchdogService 是 ConnectivityService 所 启动 的 服务 ， 但 它 并 不 是 通过 Binder 
来 实现 的 服务 。 它 的 作用 是 监控 同一 个 网 络 内 的 接 入 点 (Access Point)， 如 果 当 前 接 入 点 的 
DNS 无 法 ping 通 ， 就 自动 切换 到 下 一 个 接 入 点 。WifiWatchdogService 通过 WifiManger 和 
WifiStateTracker 辅助 完成 具体 的 控制 动作 。 在 WifiWatchdogService 初始 化 时 ， 通 过 
registerForWifiBroadcasts 注册 获取 网 络 变化 的 BroadcastReceiver ， 也 就 是 捕获 
WifiStateTracker 所 发 出 的 通知 消息 ， 并 开启 一 个 WifiWatchdogThread 线程 来 处 理 获 取 的 
消息 。 通 过 更 改 Setting.Secure.WIFI WARCHDOG ON 的 配置 ， 可 以 开启 和 关闭 
WifiWatchdogService。 


8.24 ”Setting 中 的 设置 部 分 


Android 的 Settings 应 用 程序 对 Wi-Fi 的 使 用 ， 是 典型 的 Wi-Fi 应 用 方式 ， 也 是 用 户 可 
见 的 Android Wi-Fi 管理 程序 。 此 部 分 源 代码 的 目录 如 下 : 


packages/apps/Settings/src/com/android/settings/wifi/ 


Setting 里 的 Wi-Fi 部 分 是 用 户 可 见 的 设置 界面 ， 提 供 Wi-Fi 开关 、 扫 描 AP、 链 接 / 断 
开 的 基本 功能 。 另 外 ， 通 过 实现 WifiLayer.Callback 接口 提供 了 一 组 回调 函数 ， 用 以 响应 
用 户 关心 的 Wi-Fi 状态 的 变化 。 

WifiEnabler 和 WifiLayer 都 是 WifiSettings 的 组 成 部 分 ， 同 样 通过 WifiManger 来 完成 
实际 的 功能 ， 也 同样 注册 一 个 BroadcastReceiver 来 响应 WifiStateTracker 所 发 出 的 通知 消 
息 。WifiEnabler 其 实 是 一 个 比较 简单 的 类 ， 提 供 开启 和 关闭 Wi-Fi 的 功能 ， 设 置 其 中 的 外 
HE WiFi 开关 菜单 ， 就 是 直接 通过 它 来 做 到 的 ; 而 Wifibayer 则 提供 更 复杂 的 一 些 Wi-Fi 
功能 ， 如 AP 选择 等 以 供用 户 自 定义 。 


lik 
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具体 结构 如 图 8-6 所 示 。 


图 8-6 Setting 中 的 Wi-Fi 设 置 结构 


8.3 开发 Wi-Fi 应 用 程序 


经 过 本 章 前 面 内 容 的 学 习 ， 已 经 了 解 了 Android 系统 Wi-Fi 的 基本 知识 。 根 据 对 上 述 
从 底层 到 应 用 的 学 习 ， 了 解 了 Wi-Fi 的 工作 原理 和 机 制 。 本 节 将 根据 前 面 所 学 应 用 到 具体 
实践 中 ， 通 过 具体 实例 来 掌握 在 Android 中 开发 Wi-Fi 应 用 的 基本 知识 。 


8.3.1 WifiManager 类 


在 应 用 层 开发 Wi-Fi 程序 ， 其 实 就 是 使 用 WifiManager 类 来 开发 应 用 程序 。 在 此 类 中 
提供 了 监控 Wi-Fi 状态 的 方法 ， 主 要 有 以 下 5 种 状态 。 

Q  WifiManager. WIFI STATE ENABLING: 表示 Wi-Fi 已 经 打开 。 

Q WifiManager. WIFI STATE DISABLING: 表示 Wi-Fi 正在 关闭 而 无 法 关闭 。 

Q WifiManager.WIFI STATE DISABLED: 表示 Wi-Fi 已 经 关闭 。 

Q WifiManager.:WIFI STATE ENABLED: 表示 Wi-Fi 已 经 打开 无 法 再 打开 。 

Q WifiManager.WIFL STATE UNKNOWN: 表示 Wi-Fi 无 法 识别 。 

在 具体 实现 上 ， 我 们 先 定义 一 个 复 选 框 CheckBox， 然 后 捕捉 CheckBox 的 点 击 事件 ， 
根据 对 应 的 状态 显示 对 应 的 提示 。 例 如 可 以 用 下 面 的 代码 检测 Wi-Fi 是 否 启动 : 

WifiManager wm = (WifiManager) 

context.getSystemService (Context.WIFI SERVICE); 


if(wm.getWifiState() == WifiManager.WIFI STATE ENABLED) { 
return true; 


) 
设置 Wi-Fi 可 用 的 代码 如 下 : 


wifimanager.setWifiEnabled(!wifiEnabled); 


0B 第 8 章 在 Android 中 开发 Wi-Fi 应 用 


例如 下 面 的 一 段 代码 是 通用 的 Wi-Fi 应 用 程序 。 


import java.util.List; 


import android.content.Context; 

import android.net.wifi.ScanResult; 

import android.net.wifi.WifiConfiguration; 
import android.net.wifi.WifiInfo; 

import android.net.wifi.WifiManager; 

import android.net.wifi.WifiManager.WifiLock; 


public class WifiAdmin 


{ 


// 定 义 WifiManager X] 
private WifiManager mWifiManager; 
/ [s& X Wifilnfo 对 象 
private Wifilnfo mWifiInfo; 
// 扫 描 出 的 网 络 连 接 列表 
private List«ScanResult» mWifiList; 
// 网 络 连接 列表 
private List«WifiConfiguration» mWifiConfiguration; 
// 定 义 一 个 WifiLock 
WifiLock mWifiLock; 
// 构 造 器 
public WifiAdmin(Context context) 
{ 
// 取 得 WifiManager WR 
mWifiManager = (WifiManager) context.getSystemService 
(Context.WIFI SERVICE); 
// 取 得 WifiInfo WR 
mWifiInfo = mWifiManager.getConnectionInfo(); 
) 
7/409" Wi-Fi 
public void OpenWifi() 
{ 
if (!mWifiManager.isWifiEnabled()) 


t 
mWifiManager.setWifiEnabled (true); 
} 
} 
/ [XM] Wi-Fi 
public void CloseWifi() 
{ 
if (!mWifiManager.isWifiEnabled()) 
t 
mWifiManager.setWifiEnabled(false); 
} 


} 
// 锁 定 WifiLock， 当 下 载 大 文件 时 需要 锁定 
public void AcquireWifiLock() 
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t 


mWifiLock.acquire(); 
) 
/ /fi Sli WifiLock 
public void ReleaseWifiLock() 
í 
// 判 断 时 候 锁 定 
if (mWifiLock.isHeld()) 
t 
mWifiLock.acquire(); 
$ 


} 
// 创 建 一 个 WifiLock 
public void CreatWifiLock() 


it 
mWifiLock = mWifiManager.createWifiLock ("Test"); 


) 
// 得 到 配置 好 的 网 络 
public List«WifiConfiguration» GetConfiguration() 


{ 
return mWifiConfiguration; 


} 
// 指 定 配置 好 的 网 络 进行 连接 
public void ConnectConfiguration(int index) 
{ 
// 索 引 ， 大 于 配置 好 的 网 络 索引 返回 
if(index > mWifiConfiguration.size()) 
t 
return; 
) 
// 连 接 配 置 好 的 指定 ID 的 网 络 
mWifiManager.enableNetwork (mWifiConfiguration.get (index) .networkId, 
true); 
) 
public void StartScan() 


t 
mWifiManager.startScan(); 
// 得 到 扫描 结果 
mWifiList = mWifiManager.getScanResults(); 
// 得 到 配置 好 的 网 络 连接 


mWifiConfiguration = mWifiManager.getConfiguredNetworks(); 


} 
// 得 到 网 络 列表 
public List<ScanResult> GetWifiList () 


{ 
return mWifiList; 


} 
// 查 看 扫描 结果 
public StringBuilder LookUpScan() 


t 
StringBuilder stringBuilder - new StringBuilder(); 
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for (int i = 0; i < mWifiList.size(); i++) 
{ 


stringBuilder.append("Index "+new Integer(i + 1).toString() + ":"); 
// 将 ScanResult 信息 转换 成 一 个 字符 串 包 
// 其 中 包括 : BSSID. SSID. capabilities. frequency. level 
stringBuilder.append( (mWifiList.get(i)).toString()); 
stringBuilder.append ("An"); 

} 

return stringBuilder; 


// 得 到 MAC 地 址 
public String GetMacAddress () 


return (mWifiInfo == null) ? "NULL" : mWifiInfo.getMacAddress(); 


// 得 到 接 入 点 的 BSSID 

public String GetBSSID() 
t 
return (mWifilnfo == null) ? "NULL" : mWifiInfo.getBSSID(); 


// 得 到 TP 地 址 
public int GetIPAddress () 
{ 


~ 


return (mWifiInfo == null) 0 : mWifiInfo.getIpAddress(); 


) 
// 得 到 连接 的 ID 
public int GetNetworkId() 


{ 
return (mWifiInfo == null) ? 0 : mWifiInfo.getNetworkId(); 
} 
// 得 到 WifiInfo 的 所 有 信息 包 
public String GetWifiInfo() 
{ 
return (mWifiInfo == null) ? "NULL" : mWifilnfo.toString(); 


) 
// 添 加 一 个 网 络 并 连接 
public void AddNetwork (WifiConfiguration wcg) 
{ 
int wcgID = mWifiManager.addNetwork (wcg) ; 
mWifiManager.enableNetwork(wcgID, true); 


} 

// 断 开 指定 ID 的 网 络 

public void DisconnectWifi(int netId) 

{ 
mWifiManager.disableNetwork (netId); 
mWifiManager.disconnect(); 


H 
在 具体 开发 Wi-Fi 应 用 程序 时 需要 注意 两 点 。 
第 一 是 需要 检测 当前 设备 是 否 有 可 用 的 Wi-Fi。 例 如 下 面 的 检测 代码 : 
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mWifiManager = (WifiManager) 
context.getSystemService (Context.WIFI SERVICE); 


if (mWifiManager !- null) ( 
List<ScanResult> wifiScanResults = mWifiManager.getScanResults|(); 
if (wifiScanResults != null && wifiScanResults.size() != 0) { 


m 
5 
第 二 点 是 需要 在 程序 中 声明 一 些 相关 的 权限 。Wi-Fi 的 主要 操作 权限 有 以 下 四 个 。 
CHANGE NETWORK STATE: 允许 修改 网 络 状态 的 权限 。 
CHANGE WIFI STATE: 允许 修改 Wi-Fi 状态 的 权限 。 
ACCESS NETWORK STATE: 允许 访问 网 络 状态 的 权限 。 
ACCESS WIFI STATE: 允许 访问 Wi-Fi 状态 的 权限 。 
例如 下 面 的 代码 : 
<uses-permission 
android:name="android.permission.ACCESS WIFI STATE"></uses-permission> 
«uses-permission android:name-"android.permission.ACCESS CHECKIN PROPERTIES"> 


«/uses-permission» 
«uses-permission android:name-"android.permission.WAKE LOCK"> 


u 
a 
a 
Q 


«/uses-permission» 

«uses-permission android:name-"android.permission.INTERNET"» 
«/uses-permission» 

«uses-permission android:name-"android.permission.CHANGE WIFI STATE"> 
«/uses-permission» 

«uses-permission android:name-"android.permission.MODIFY PHONE STATE"> 
«/uses-permission» 


8.3.2 ”在 Android 系 统 中 控制 Wi-Fi 


TREY Wi-Fi 的 基本 知识 后 ， 在 接 下 来 的 内 容 中 ， 将 通过 两 个 具体 实例 的 实现 过 程 ， 
来 讲解 在 Android 系统 中 开发 Wi-Fi 应 用 程序 的 基本 流程 。 


实例 | 功 能 源码 路 径 | 
实例 8-1 | 在 Android 系统 中 控制 Wi-Fi 下 载 路 径 :\daima\8\control | 


本 实例 的 功能 是 在 Android 系统 中 控制 Wi-Fi 的 状态 ， 具 体 实现 流程 如 下 。 
(1) 编写 布局 文件 main.xml， 具 体 代码 如 下 : 


«?xml version-"1.0" encoding="utf-8"?> 

<LinearLayout 
xmlns:android-"http://schemas.android.com/apk/res/android" 
android:background="@drawable/white" 
android:orientation="vertical" 
android:layout width="fill parent" 
android:layout height="fill parent" 
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<TextView 
android: id="@+id/myTextViewl" 
android:layout width="fill parent" 
android:layout height="wrap content" 
android: textColor="@drawable/blue" 
android: text="@string/hello" 

/> 

<CheckBox 
android: id="@+id/myCheckBox1" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:text="@string/str checked" 
android: textColor="@drawable/blue" 

{> 

</LinearLayout> 


(2) 实现 主 程序 文件 controljava， 具 体 实现 流程 如 下 。 
© 创建 WifiManager XJ $t mWiFiManager01， 具 体 代码 如 下 : 


public class control extends Activity 


{ 
private TextView mTextView01; 


private CheckBox mCheckBox01; 


/* 创建 WifiManager 对 象 */ 
private WifiManager mWiFiManager01; 


© 定义 mTextView01 和 mCheckBox01， 分 别 用 于 显示 提示 文本 和 获取 复 选 框 的 选择 
状态 。 具 体 代码 如 下 : 
/** Called when the activity is first created. */ 


@override 
public void onCreate (Bundle savedInstanceState) 


{ 
super .onCreate (savedInstanceState) ; 
setContentView (R. layout.main) ; 


mTextView0l = (TextView) findViewById(R.id.myTextViewl) ; 
mCheckBox01 (CheckBox) findViewById(R.id.myCheckBox1) ; 


(3) 以 getSystemService 取得 WIFI SERVICE， 具 体 代 码 如 下 : 


mWiFiManager01 = (WifiManager) 
this.getSystemService(Context.WIFI SERVICE); 


@ 通过 if 语句 来 判断 运行 程序 后 的 Wi-Fi 状态 是 否 打开 或 打开 中 ， 这 样 便 可 显示 对 
应 的 提示 信息 。 具 体 代 码 如 下 : 
/* 判断 运行 程序 后 的 Wi-Fi 状态 是 否 打 开 或 打开 中 */ 
if (mWwiFiManager0l.isWifiEnabled()) 


t 
/* FA Wi-Fi 状态 是 否 “ 已 打开 ” */ 
if (mwiFiManager0l.getWifiState()-— 
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WifiManager.WIFI STATE ENABLED) 


/* diwi-Fi 已 打开 ， 将 选取 项 打 勾 */ 
mCheckBox01.setChecked (true); 
/* 更 改选 取 项 文字 为 关闭 Wi-Fi*/ 
mCheckBox01.setText (R.string.str uncheck); 
} 
else 
{ 
/* 若 Wi-Ei 未 打开 ， 将 选取 项 色 取 消 */ 
mCheckBox01.setChecked (false); 
/* 更 改选 取 项 文字 为 打开 wi-Fi*/ 
mCheckBox01.setText (R.string.str checked); 
} 
y 
else 
{ 
mCheckBox01 .setChecked (false) ; 
mCheckBox01.setText (R.string.str checked); 
} 


© 通过 mCheckBoxOl.setOnClickListener 来 捕捉 CheckBox 的 点 击 事件 ， 用 
onClick(View v) 方 法 获取 用 户 的 点 击 ， 然 后 根据 if 语句 的 操作 需求 来 执行 对 应 操作 ， 并 根 
据 需 要 输出 对 应 的 提示 信息 。 具 体 代码 如 下 : 


mCheckBox01.setOnClickListener ( 
new CheckBox.OnClickListener () 
{ 
@override 
public void onClick(View v) 
{ 
// TODO Auto-generated method stub 
/* 当选 取 项 为 取消 选取 状态 */ 
if (mCheckBox01.isChecked()--false) 
t 
/* 尝试 关闭 Wi-Fi 服务 */ 
try 
t 
/* 判断 Wi-Fi 状态 是 否 为 已 打开 */ 
if (mWiFiManager0l.isWifiEnabled() ) 
{ 
/* 关闭 Wi-Fi */ 
if (mWiFiManager01.setWifiEnabled (false) ) 
{ 
mTextView01.setText (R.string.str stop wifi done); 
} 
else 
t 
mTextView01.setText (R.string.str stop wifi failed); 
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else 
t 
/* Wi-Fi 状态 不 为 已 打开 状态 时 */ 
switch (mWiFiManager0l.getWifiState()) 
t 
/* Wi-Fi 正在 打开 过 程 中 ， 导 致 无 法 关闭 . . */ 
case WifiManager.WIFI STATE ENABLING: 
mTextView0l.setText 
( 
getResources ().getText 
(R.string.str stop wifi failed)+":"+ 
getResources().getText 
(R.string.str wifi enabling) 
) 
break; 
/* Wi-Fi 正在 关闭 过 程 中 ， 导 致 无 法 关闭 ... */ 
case WifiManager.WIFI STATE DISABLING: 
mTextView0l.setText 
( 
getResources().getText 
(R.string.str stop wifi failed)+":"+ 
getResources().getText 
(R.string.str wifi disabling) 
) 7 
break; 
/* Wi-Fi 已 经 关闭 */ 
case WifiManager.WIFI STATE DISABLED: 
mTextView0l.setText 
( 
getResources ().getText 
(R.string.str stop wifi failed)+":"+ 
getResources().getText 
(R.string.str wifi disabled) 
) 7 
break; 
/* 无 法 取得 或 辨识 Wi-Fi 状态 */ 
case WifiManager.WIFI STATE UNKNOWN: 
default: 
mTextView01.setText 
( 
getResources() .getText 
(R.string.str stop wifi failed)+":"+ 
getResources() .getText 
(R.string.str_wifi_unknow) 
de 
break; 
} 
mCheckBox01.setText (R.string.str checked); 
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catch (Exception e) 
t 
Log.i("HIPPO", e.toString()); 
e.printStackTrace(); 
} 
} 
else if (mCheckBox01.isChecked ()==true) 
{ 
/* 尝试 打开 Wi-Fi 服务 */ 
try 
{ 
/* WM Wi-Fi 服务 是 关闭 且 不 在 打开 作业 中 */ 
if (!mWiFiManager0l.isWifiEnabled() && 
mWiFiManager01.getWifiState() != 
WifiManager.WIFI STATE ENABLING ) 
{ 
if (mWiFiManager01.setWifiEnabled (true) ) 
{ 
switch (mWiFiManager01.getWifiState()) 
t 
/* Wi-Fi 正在 打开 过 程 中 ， 导 致 无 法 打开 . . .*/ 
case WifiManager.WIFI STATE ENABLING: 
mTextView0l.setText 
( 
getResources().getText 
(R.string.str wifi enabling) 
); 
break; 
/* Wi-Fi 已 经 为 打开 ， 无 法 再 次 打开 . . 。*/ 
case WifiManager.WIFI STATE ENABLED: 
mTextView0l.setText 
( 
getResources ().getText 
(R.string.str start wifi done) 
) 7 
break; 
/* 其 他 未 知 的 错误 */ 
default: 
mTextView0l.setText 
( 
getResources() .getText 
(R.string.str start wifi failed)+":"+ 
getResources () .getText 
(R.string.str wifi unknow) 
); 
break; 


} 
else 


t 
mTextView0l.setText(R.string.str start wifi failed); 
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} 
else 
{ 
switch (mWiFiManager01.getWifiState() ) 
{ 
/* Wi-Fi 正在 打开 过 程 中 ， 导 致 无 法 打开 ... */ 
case WifiManager.WIFI STATE ENABLING: 
mTextView01.setText 
( 
getResources () .getText 
(R.string.str start wifi failed)+":"+ 
getResources () .get Text 
(R.string.str wifi enabling) 
) 
break; 
/* Wi-Fi 正在 关闭 过 程 中 ， 导 致 无 法 打开 . .. */ 
case WifiManager.WIFI STATE DISABLING: 
mTextView0l.setText 
( 
getResources ().getText 
(R.string.str start wifi failed)+" 
getResources() .getText 
(R.string.str wifi disabling) 
) 
break; 
/* Wi-Fi 已 经 关闭 */ 
case WifiManager.WIFI STATE DISABLED: 
mTextView0l.setText 
( 
getResources ().getText 
(R.string.str start wifi failed)+" 
getResources().getText 
(R.string.str wifi disabled) 
) 7 
break; 
/* 无 法 取得 或 识别 Wi-Fi 状态 */ 
case WifiManager.WIFI STATE UNKNOWN: 
default: 
mTextView0l.setText 
( 
getResources() .getText 
(R.string.str start wifi failed)+":"+ 
getResources() .getText 
(R.string.str wifi unknow) 
Ve 
break; 


h 
mCheckBox01.setText (R.string.str uncheck); 
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catch (Exception e) 


t 
Log.i("HIPPO", e.toString()); 
e.printStackTrace(); 


© EX mMakeTextToast(String str, boolean isLong)， 用 于 根据 当前 操作 显示 对 应 的 提 
示 性 信息 。 有 具体 代码 如 下 : 


public void mMakeTextToast (String str, boolean isLong) 
t 
if (isLong==true) 
{ 
Toast.makeText(examplellO0.this, str, Toast.LENGTH LONG) .show(); 
} 
else 
{ 
Toast.makeText(examplellO0.this, str, Toast.LENGTH SHORT) .show(); 
} 


GOverride 
protected void onResume() 
t 
// TODO Auto-generated method stub 


/* 在 onResume 重 写 事件 为 取得 打开 程序 当下 Wi-Fi 的 状态 */ 
try 
t 
switch (mWiFiManager01l.getWifiState()) 
t 
/* Wi-Fi 已经 在 打开 状态 ... */ 
case WifiManager.WIFI STATE ENABLED: 
mTextView0l.setText 
( 
getResources ().getText(R.string.str wifi enabling) 
) 
break; 
/* Wi-Fi 正在 打开 过 程 中 -5/ 
case WifiManager.WIFI STATE ENABLING: 
mTextView0l.setText 
( 
getResources().getText(R.string.str wifi enabling) 
UE 
break; 
/* Wi-Fi 正在 关闭 过 程 中 - - - */ 
case WifiManager.WIFI STATE DISABLING: 
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mTextView0l.setText 
( 
getResources().getText(R.string.str wifi disabling) 
); 
break; 
/* Wi-Fi 已 经 关闭 */ 
case WifiManager.WIFI STATE DISABLED: 
mTextView01.setText 
( 
getResources () .getText (R.string.str wifi disabled) 
7 
break; 
/* 无 法 取得 或 识别 Wi-Fi 状态 */ 
case WifiManager.WIFI STATE UNKNOWN: 
default: 
mTextView0l.setText 
( 
getResources().getText(R.string.str wifi unknow) 
); 
break; 


} 

catch (Exception e) 

{ 
mTextView01.setText (e.toString()); 
e.getStackTrace(); 

) 

super.onResume () ; 

) 


@override 
protected void onPause() 
{ 
// TODO Auto-generated method stub 
super.onPause(); 
5 
j: 


G) 编写 文件 strings.xml， 此 处 设置 了 在 屏幕 中 显示 的 文本 内 容 。 具 体 代码 如 下 : 


<?xml version-"1.0" encoding-"utf-8"?» 

«resources» 
«string name-"hello"»«/string» 
«string name-"app name"></string> 
«string name-"str checked"»1TJf....«/string» 
«string name-"str uncheck"»XH]....«/string» 
«string name-"str start wifi failed"> 打 开 失 败 </string> 
«string name-"str start wifi done"> 打 开 成 功 </string> 
<string name="str stop wifi failed"> 打 开 失 败 </string> 
«string name-"str stop wifi done"> 关 闭 成 功 </string> 
«string name-"str wifi enabling"> 正 在 启动 . . - .</string> 
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«string name-"str wifi disabling"> 正 在 关闭 . . . .</string> 
«string name-"str wifi disabled"> 已 关闭 </string> 


«string name-"str wifi unknow"> 未 知 ....</string> 
</resources> 
(4) 在 文件 AndroidManifest.xml 中 添加 对 Wi-Fi 的 访问 以 及 对 网 络 状态 的 权限 。 具 体 
代码 如 下 : 


<uses-permission android:name-"android.permission.CHANGE NETWORK STATE" /> 
«uses-permission android:name-"android.permission.CHANGE WIFI STATE" /» 
«uses-permission android:name-"android.permission.ACCESS NETWORK STATE" /» 
«uses-permission android:name-"android.permission.ACCESS WIFI STATE" /> 
<uses-permission android:name-"android.permission.INTERNET" /> 
«uses-permission android:name-"android.permission.WAKE LOCK" /> 


到 此 为 止 ， 整 个 实例 介绍 完毕 ， 执 行 后 会 显示 两 个 按钮 ， 如 图 8-7 所 示 。 当 选择 复 选 
框 后 会 执行 对 应 的 操作 处 理 ， 并 且 显 示 对 应 的 提示 信息 。 


已 关闭 


Bn. 


图 8-7 ”执行 效果 
在 此 需要 说 明 的 是 ， 由 于 Android 模拟 器 不 支持 Wi-Fi 和 蓝牙 ， 所 以 执行 上 述 程序 时 
返回 的 网 卡 状态 都 是 WIFI STATE UNKNOWN， 即 表示 网 卡 未 知 的 状态 。 


8.3.3 在 Android 系 统 中 打开 或 关闭 Wi-Fi 网 卡 


本 实例 新 建 了 一 个 Android 应 用 程序 ， 在 main.xml 中 添加 三 个 按钮 ， 点 击 这 三 个 按钮 
分 别 可 以 打开 Wi-Fi 网 卡 、 关 闭 Wi-Fi 网 卡 、 检 查 网 卡 的 当前 状态 。 本 实例 的 具体 实现 流 
程 如 下 。 

(1) 编写 布局 文件 main.xml， 具 体 代码 如 下 : 


«?xml version-"1.0" encoding-"utf-8"?» 

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="fill parent" 
android: layout_height="fill_ parent" 
> 

<TextView 
android:layout width="fill parent" 
android:layout height="wrap content" 
android: text="@string/hello" 
/> 


«Button 
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android:id="@+id/startButton" 
android:layout width="300dp" 
android:layout height="wrap content" 
android:text-"jTJf WIFI WF" 


/> 


<Button 


android: id="@+id/stopButton" 
android: layout width="300dp" 
android:layout height="wrap content” 
android:text-' XB] WIFI 网卡 " 


/> 


<Button 


android: id="@+id/checkButton" 
android:layout width="300dp" 
android:layout height="wrap content” 
android:text=" 检 查 WIFI 网 卡 状态 " 


/> 


</LinearLayout> 


(2) 编写 主 程序 文件 Android Wifijava， 具 体 代码 如 下 : 


package idea.org; 


import 
import 
import 
import 
import 
import 
import 
import 


public 


android.app.Activity; 
android.content.Context; 
android.net.wifi.WifiManager; 
android.os.Bundle; 
android.view.View; 
android.view.View.OnClickListener; 
android.widget.Button; 
android.widget.Toast; 


class Android Wifi extends Activity ( 


private Button startButton-null; 
private Button stopButton-null; 
private Button checkButton-null; 
WifiManager wifiManager-null; 
@override 


public void onCreate (Bundle savedInstanceState) { 
super .onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 
startButton- (Button) findViewById (R.id.startButton); 
stopButton- (Button) findViewById (R.id.stopButton); 
checkButton- (Button) findViewById (R.id.checkButton); 
startButton.setOnClickListener(new startButtonListener()); 
stopButton.setOnClickListener(new stopButtonListener()); 
checkButton.setOnClickListener (new checkButtonListener()); 


} 


class startButtonListener implements OnClickListener 


t 


/* (non-Javadoc) 
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* (see android.view.View.OnClickListenerfonClick (android.view.View) 
sj 
@override 
public void onClick(View v) { 
// TODO Auto-generated method stub 
wifiManager=(WifiManager) Android Wifi.this.getSystemService 
(Context.WIFI SERVICE) ; 
wifiManager.setWifiEnabled (true); 
System.out.println("wifi state ——-»"-4wifiManager.getWifistate()); 
Toast.makeText (Android Wifi.this，" 当 前 网 卡 状 态 为 : "+ 
wifiManager.getWifiState(), Toast.LENGTH SHORT).show(); 


} 
class stopButtonListener implements OnClickListener 
{ 
/* (non-Javadoc) 
* @see android.view.View.OnClickListener#onClick (android.view.View) 
E 
@override 
public void onClick(View v) { 
// TODO Auto-generated method stub 
wifiManager=(WifiManager) Android Wifi.this.getSystemService 
(Context.WIFI SERVICE); 
wifiManager.setWifiEnabled(false); 
System.out.println("wifi state --->"+wifiManager.getWifiState()); 
Toast .makeText (Android Wifi.this，" 当 前 网 卡 状 态 为 : "+wifiManager.getWifistate(), 
Toast.LENGTH SHORT).show(); 
) 


) 
class checkButtonListener implements OnClickListener 
t 
/* (non-Javadoc) 
* @see android.view.View.OnClickListener#onClick (android.view.View) 
ay) 
GOverride 
public void onClick(View v) ( 
// TODO Auto-generated method stub 
wifiManager- (WifiManager)Android Wifi.this.getSystemService 
(Context.WIFI SERVICE); 
System.out.println("wifi state --->"+wifiManager.getWifiState()); 
Toast.makeText (Android Wifi.this，" 当 前 网 卡 状态 为 : "+ 
wifiManager.getWifiState(), Toast.LENGTH SHORT) .show() 


} 
(3) 在 文件 AndroidManifest.xml 中 声明 Wi-Fi 权限 ， 具 体 代码 如 下 : 


«?xml version-"1.0" encoding-"utf-8"?» 
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«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package-"idea.org" 
android:versionCode-"1" 
android:versionName-"1.0"» 
«uses-sdk android:minSdkVersion="11" /> 
«application android:icon="@drawable/icon" android:label="@string/app name"> 
<activity android:name=".Android Wifi" 
android: label="@string/app name"> 
<intent-filter> 
<action android:name="android.intent.action.MAIN" /> 
«category android:name-"android.intent.category.LAUNCHER" /> 
«/intent-filter» 
</activity> 
</application> 
<uses-permission android:name="android.permission.CHANGE NETWORK STATE"/> 
«uses-permission android:name="android.permission.CHANGE WIFI STATE"/> 
«uses-permission android:name="android.permission.ACCESS NETWORK STATE"/> 
«uses-permission android:name="android.permission.ACCESS WIFI STATE"/> 
</manifest> 


执行 后 的 效果 如 图 8-8 所 示 。 


Android Wifi 


打开 WIFI 网 卡 


关闭 WIFI 网 卡 


检查 WIFI 网 卡 状态 


图 8-8 执行 效果 
依次 单 击 “ 打 开 WIFI 网 卡 ”、“ 关 闭 WIFI 网 卡 ”、“ 检 查 WIFI 网 卡 状态 ”三 个 按 
钮 ， 控 制 台 输 出 对 应 内 容 。 在 Eclipse 中 会 显示 对 应 的 状态 值 ， 如 图 8-9 所 示 。 


WP LogCat £3 


Log (6) System.out 


Tine pid tag Message 

05-27 04:04 I 499 System out wifi state 
05-27 04:04 I 499 Systen out vifi state 
05-27 04:04 I 499 System out vifi state ——»4 


图 8-9 Eclipse 中 的 值 
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RSS 是 在 线 共 享 内 容 的 一 种 简易 方式 (也 叫 聚 合 内 容 ， 
Really Simple Syndication)。 通 常 在 时 效 性 比较 强 的 内 容 上 使 用 
RSS 订阅 能 更 快速 地 获取 信息 。 网 站 提供 RSS 输出 ， 有 利于 让 
用 户 获取 网 站 内 容 的 最 新 更 新 。 本 章 将 讲解 在 Android 手机 中 
实现 RSS 处 理 的 基本 知识 。 
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9.1 RSS 基础 


RSS 通常 被 用 在 时 效 性 比较 强 的 内 容 上 ， 通 过 使 用 RSS 订阅 可 以 更 快速 地 获取 信息 。 
在 网 站 中 提供 RSS 输出 ， 有 利于 让 用 户 获 取 网 站 内 容 的 最 新 更 新 。 


9.1.1 RSS 的 用 途 


RSS 的 主要 用 途 如 下 。 

(1) 订阅 Blog( 你 可 以 订阅 工作 中 所 需 的 技术 文章 ， 也 可 以 订阅 与 你 有 共同 爱好 的 作者 
的 Blog， 总 之 ， 你 对 什么 感 兴趣 就 可 以 订阅 了 什么 )。 

(2) 订阅 新 闻 ( 无 论 是 奇闻 怪事 、 明 星 消息 、 体 坛 风云 ， 只 要 你 想 知道 的 ， 都 可 以 订 
阅 )。 

(3) 再 也 不 用 一 个 网 站 一 个 网 站 、 一 个 网 页 一 个 网 页 去 逛 了 。 只 要 将 你 需要 的 内 容 订 
阅 在 一 个 RSS 阅读 器 中 ， 这 些 内 容 就 会 自动 出 现在 你 的 阅读 器 中 ， 你 也 不 必 为 了 一 个 急切 
想 知 道 的 消息 而 不 断 地 刷新 网 页 ， 因 为 一 旦 有 了 更 新 ，RSS 阅读 器 就 会 通知 你 。 

其 实 订阅 RSS 新 闻 内 容 要 先 安装 一 个 RSS 阅读 器 ， 然 后 将 提供 RSS 服务 的 网 站 加 入 
到 RSS 阅读 器 的 频道 即 可 。 具 体 如 下 。 

(1) 选择 有 价值 的 RSS 信息 源 。 

(2) 启动 RSS 订阅 程序 ， 将 信息 源 添加 到 自己 的 RSS 阅读 器 或 者 在 线 RSS. 

(3) 接收 并 获取 定制 的 RSS 信息 。 


9.1.2 RSS 阅读 器 


RSS 阅读 器 可 以 分 为 以 下 三 类 。 

1) 计算 机 桌面 程序 

大 多 数 阅读 器 是 运行 在 计算 机 桌面 上 的 应 用 程序 ， 通 过 所 订阅 网 站 的 新 闻 供 应 ， 可 自 
动 、 定 时 地 更 新 新 闻 标 题 。 在 该 类 阅读 器 中 ， 有 Awasu, FeedDemon 和 RSSReader 三 款 流 
行 的 阅读 器 ， 均 提供 免费 试用 版 和 付费 高 级 版 。 

2) 新 闻 阅 读 器 

新 闻 阅 读 器 通常 内 嵌 于 已 在 计算 机 中 运行 的 应 用 程序 中 。 例 如 ，NewsGator Wy ik Ze tk 
软 的 Outlook 中 ， 所 订阅 的 新 闻 标 题 位 于 Outlook 的 收 件 箱 文件 夹 中 。 另 外 ，Pluck ATK AE 
Internet Explorer 浏览 器 中 。 

3) 在 线 的 Web RSS 阅读 器 

在 线 Web RSS 阅读 器 的 优势 是 ， 不 需要 安装 任何 软件 就 可 以 获得 RSS 阅读 的 便利 ， 
并 且 可 以 保存 阅读 状态 ， 推 荐 和 收藏 自己 感 兴趣 的 文章 。 提 供 此 服务 的 网 站 有 两 类 ， 一 类 
是 专门 提供 RSS 阅读 器 的 网 站 ， 例 如 国外 的 Google Reader， 国 内 的 鲜果 、 抓 虾 ， 另 一 类 
是 提供 个 性 化 首页 的 网 站 ， 例 如 国外 的 Netvibes、Pageflakes， 国 内 的 雅 蛙 、 阔 地 。 
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9.1.3 RSS 的 语法 


RSS 2.0 的 语法 规则 非常 简单 并 十 分 的 严格 ， 看 下 面 的 代码 : 


<?xml version-"1.0" encoding-"ISO-8859-1" ?> 
«rss version="2.0"> 
«channel» 


<title>W3Schools</title> 
<link>http: //www.w3schools.com</link> 
<description>W3Schools Web Tutorials </description> 


<item> 

<title>RSS Tutorial</title> 
«link»http://www.w3schools.com/rss«/link» 
<description>Check out the RSS tutorial 
on W3Schools.com«/description» 

«/item» 


</channel> 
</rss> 
其 中 ，<channel> 元 素 内 是 描述 RSS feed 的 地 方 。 
RSS 的 <channel> 元 素 是 项 目 内容 显 示 的 地 方 。 它 就 像 RSS 的 标题 。 通 常 它 不 会 频繁 
地 改动 。 有 三 个 内 部 元 素 是 必 选 的 ， 分 别 是 <title>、<link> 和 <description>。 具 体 说 明 如 下 。 
Q <title>: 包含 你 的 网 站 和 你 的 RSS feed 简短 说 明 。 
Q linke: 定义 你 的 网 站 主页 的 链接 。 
Q <description>: 描述 你 的 RSS feed. 
<channel> 内 的 可 选 元 素 如 下 。 
<category>: 定义 一 个 或 多 个 频道 分 类 。 
<cloud>: 允许 更 新 通告 。 
<copyright>: 提醒 有 关 版 权 。 
<docs>: 频道 所 使 用 的 RSS 版 本 文档 URL。 
<generator>: 如 果 频 道 是 自动 生成 器 产生 的 ， 就 在 这 里 定义 。 
<image>: 为 频道 加 图 片 。 
<language>: 描述 频道 所 使 用 的 语言 。 
<lastBuildDate>: 定义 频道 最 近 一 次 改动 的 时 间 。 
<managingEditor>: 定义 编辑 站 点 人 员 的 E-mail 地 址 。 
<pubDate>: 定义 频道 最 新 的 发 布 时 间 。 
<rating>: 页 面 评估 。 
«b: 存活 的 有 效 时 间 。 
<webMaster>: 定义 站 点 的 邮件 地 址 。 
<item> 元 素 内 是 你 的 网 站 连接 和 描述 更 新 内 容 的 地 方 。<item> 是 显示 RSS 更 新 内 容 的 
地 方 。 它 像 是 文章 的 标题 。 当 你 的 站 点 有 更 新 时 ，RSS feed 中 的 <item> 元 素 就 会 被 建立 起 
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来 。<item> 元 素 中 有 几 个 可 选 的 元 素 ， 但 <title> 和 <description> 是 必 选 元 素 。 
一 个 RSS 的 <item> 应 该 包括 : <title>、<link> 和 <description> 元 素 。 
O <title>: 项 目的 题目 ， 应 该 用 十 分 简短 的 描述 。 
Q <link>: 项 目 所 关联 的 链接 。 
ū <description>: RSS feed 的 描述 部 分 ， 这 应 该 是 描述 你 的 RSS feed 项 目的 。 
<item> 中 的 可 选 元 素 如 下 。 
<author>: 定义 作者 。 
<category>: 类 别 。 
<comments>: 针对 项 目的 评论 页 URL. 
<enclosure>: 描述 一 个 与 项 目 有 关 的 媒体 对 象 。 
<guid>: 针对 项 目 定义 独特 的 标志 。 
<pubDate>: 项 目 发 布 时 间 。 
口 ”<source>: 转载 地 址 ( 源 地 址 )。 
在 <description> 中 建议 使 用 <![CDATA[ ]]>， 所 有 在 CDATA 部 件 之 间 的 文本 都 会 被 
解析 器 忽略 。 
Kj E: CDATA 部 件 之 间 不 能 再 包含 CDATA 部 件 (不 能 谨 套 )。 如 果 CDATA 部 件 包 
含 了 字符 "]]>" 或 者 CDATA， 将 很 有 可 能 出 错 。 同 样 要 注意 在 字符 串 "]]>" 之 
间 没 有 空格 或 者 换行 符 。 
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9.2 SAX 介绍 


SAX 是 Simple API for XML 的 缩写 ， 不 但 是 指 一 种 接口 ， 而 且 也 是 指 一 个 软件 包 。 
SAX 最 初 是 由 David Megginson 采用 Java 语言 开发 的 ， 之 后 SAX 很 快 在 Java 开发 者 中 流 
行 起 来 。Sun 现在 负责 管理 其 原始 API 的 开发 工作 ， 这 是 一 种 公开 的 、 开 放 源 代码 软件 。 
不 同 于 其 他 大 多 数 XML 标准 的 是 ，SAX 没有 语言 开发 商 必 须 遵守 的 标准 SAX 参考 版 
本 。 因 此 ，SAX 的 不 同 实现 可 能 采用 区 别 很 大 的 接口 。 本 节 简 要 介绍 SAX 技术 的 基本 


知识 。 
9.2.1 SAX 的 原理 


作为 接口 ，SAX 是 事件 驱动 型 XML 解析 的 一 个 标准 接口 (Standard Interface)， 不 会 改 
变 ， 已 被 OASIS(Organization for the Advancement of Structured Information Standards) 所 采 
纳 。 作 为 软件 包 ，SAX 最 早 的 开发 始 于 1997 年 12 月 ， 由 一 些 在 互联 网 上 分 散 的 程序 员 合 
作 进行 。 后 来 ， 参 与 开发 的 程序 员 越 来 越 多 ， 组 成 了 互联 网 上 的 XML-DEV 社区 。 五 个 月 
以 后 ，1998 年 5 H, SAX 1.0 版 由 XML-DEV 正式 发 布 。 目 前 ， 最 新 的 版 本 是 SAX 2.0. 
2.0 版 本 在 多 处 与 1.0 版 本 不 兼容 ， 包 括 一 些 类 和 方法 的 名 字 。 

SAX 的 工作 原理 简单 地 说 就 是 对 文档 进行 顺序 扫描 ， 当 扫描 到 文档 (documenb 开 始 与 
结束 、 元 素 (elemenb 开 始 与 结束 等 地 方 时 通知 事件 处 理 函 数 ， 由 事件 处 理 函 数 做 相应 动 
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作 ， 然 后 继续 同样 的 扫描 ， 直 至 文档 结束 。 

大 多 数 SAX 实现 都 会 产生 以 下 五 种 类 型 的 事件 。 

口 “ 在 文档 的 开始 和 结束 时 触发 文档 处 理事 件 。 
在 文档 内 每 一 XML 元 素 接 受 解析 的 前 后 触发 元 素 事件 。 
任何 元 数据 通常 都 由 单独 的 事件 交付 。 
在 处 理 文档 的 DTD 或 Schema 时 产生 DTD 或 Schema 事件 。 
产生 错误 事件 用 来 通知 主机 应 用 程序 解析 错误 。 


9.22 ”基于 对 象 和 基于 事件 的 接口 


语法 分 析 器 有 两 类 接口 : 基于 对 象 的 接口 和 基于 事件 的 接口 。 

DOM 是 基于 对 象 的 语法 分 析 器 的 标准 的 API。 作 为 基于 对 象 的 接口 ，DOM 通过 在 内 
存 中 显 式 地 构建 对 象 树 来 与 应 用 程序 通信 。 对 象 树 是 XML 文件 中 元 素 树 的 精确 映射 。 

DOM 易于 学 习 和 使 用 ， 因 为 它 与 基本 XML 文档 紧密 匹配 。 特 别 以 XML 为 中 心 的 应 
用 程序 (例如 ， 浏 览 器 和 编辑 器 ) 也 是 很 理想 的 。 以 XML 为 中 心 的 应 用 程序 为 了 操纵 XML 
文档 而 操纵 XML 文档 。 

然而 ， 对 于 大 多 数 应 用 程序 ， 处 理 XML 文档 只 是 其 众多 任务 中 的 一 种 。 例 如 ， 记 账 
软件 包 可 能 导入 XML 发 票 ， 但 这 不 是 其 主要 活动 。 计 算账 户 余额 、 跟 踪 支 出 以 及 使 付款 
与 发 票 匹 配 才 是 主要 活动 。 记 账 软件 包 可 能 已 经 具有 一 个 数据 结构 (最 有 可 能 是 数据 库 )。 
DOM 模型 不 太 适 合 记 账 应 用 程序 ， 因 为 在 那 种 情况 下 ， 应 用 程序 必须 在 内 存 中 维护 数据 
的 两 份 副本 (一 个 是 DOM 树 ， 另 一 个 是 应 用 程序 自己 的 结构 )。 至 少 ， 在 内 存 中 维护 两 次 
数据 会 使 效率 下 降 。 对 于 桌面 应 用 程序 来 说 ， 这 可 能 不 是 主要 问题 ， 但 是 有 可 能 导致 服务 
器 瘫痪 。 对 于 不 是 以 XML 为 中 心 的 应 用 程序 ，SAX 是 明智 的 选择 。 实 际 上 ，SAX 并 不 
在 内 存 中 显 式 地 构建 文档 树 。 它 使 应 用 程序 能 用 最 有 效率 的 方法 存储 数据 。 

图 9-1 说 明了 应 用 程序 是 如 何在 XML 树 及 其 自身 数据 结构 之 间 进行 映射 的 。 
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9-1 将 XML 结构 映射 成 应 用 程序 结构 


SAX 是 基于 事件 的 接口 ， 正 如 其 名 称 所 暗示 ， 基 于 事件 的 语法 分 析 器 将 事件 发 送 给 应 
用 程序 。 这 些 事件 类 似 于 用 户 界面 事件 ， 例 如 ， 浏 览 器 中 的 onClick 事件 或 者 Java 中 的 
AWT/Swing 事件 。 
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事件 通知 应 用 程序 发 生 了 某 件 事 并 需要 应 用 程序 做 出 反应 。 在 浏览 器 中 ， 通 常 为 响应 
用 户 操 作 而 生成 事件 : 当 用 户 单 击 按钮 时 ， 按 钮 产生 一 个 onClick 事件 。 

在 XML 语法 分 析 器 中 ， 事 件 与 用 户 操作 无 关 ， 而 与 正在 读 取 的 XML 文档 中 的 元 素 
有 关 。 有 对 于 以 下 方面 的 事件 。 
口 “元 素 开 始 和 结束 标记 
Q HRA 
a 实体 
口 
图 


语法 分 析 错 误 
9-2 显示 了 语法 分 析 器 在 读 取 文档 时 是 如 何 生成 事件 的 。 


00000, 


«xbe:price-list» «xbe:product» XML Training«/xbe:product»«xbe:price-quote/». . . 


图 9-2 语法 分 析 器 生成 事件 

读者 在 此 可 能 会 问 : 为 什么 使 用 基于 事件 的 接口 ? 

这 两 种 API 中 没有 一 种 在 本 质 上 更 好 ;它们 适用 于 不 同 的 需求 。 经 验 法 则 是 在 需要 更 
多 控制 时 使 用 SAX; 要 增加 方便 性 时 ， 则 使 用 DOM。 例 如 ，DOM 在 脚本 语言 中 很 流行 。 

采用 SAX 的 主要 原因 是 效率 。SAX 比 DOM 做 的 事 要 少 ， 但 提供 了 对 语法 分 析 器 的 
更 多 控制 。 当 然 ， 如 果 语 法 分 析 器 的 工作 减少 ， 则 意味 着 您 (开发 者 ) 有 更 多 的 工作 要 做 。 
而 且 ， 正 如 我 们 已 讨论 的 ，SAX 比 DOM 消耗 的 资源 要 少 ， 这 是 因为 它 不 需要 构建 文档 
树 。 在 XML 早期 ，DOM 得 益 于 W3C 批准 的 官方 API 这 一 身份 。 逐 渐 地 ， 开 发 者 选择 了 
功能 性 而 放弃 了 方便 性 ， 并 转向 了 SAX. 

SAX 的 主要 限制 是 它 无 法 向 后 浏览 文档 。 实 际 上 ， 激 发 一 个 事件 后 ， 语 法 分 析 器 就 将 

忘记 。 如 您 将 看 到 的 ， 应 用 程序 必须 显 式 地 缓冲 其 感 兴趣 的 事件 。 


9.23 ”常用 的 接口 和 类 


SAX 将 其 事件 分 为 以 下 几 个 接口 。 

Q ContentHandler: 定义 与 文档 本 身 关联 的 事件 (例如 ， 开 始 和 结束 标记 )。 大 多 数 应 
用 程序 都 注册 这 些 事件 。 

口 DTDHandler: 定义 与 DID 关联 的 事件 。 然 而 ， 它 不 定义 足够 的 事件 来 完整 地 报 
告 DID. 。 如 果 需 要 对 DID 进行 语法 分 析 ， 请 使 用 可 选 的 DeclHandler 。 
DeclHandler 是 SAX 的 扩展 ， 并 且 不 是 所 有 的 语法 分 析 器 都 支持 它 。 

Q EntityResolver: 定义 与 装 入 实体 关联 的 事件 。 只 有 少数 几 个 应 用 程序 注册 这 些 事件 。 

Q ErrorHandler: 定义 错误 事件 。 许 多 应 用 程序 注册 这 些 事件 以 便 用 它们 自己 的 方式 
报错 。 

为 简化 工作 ，SAX 在 DefaultHandler 类 中 提供 了 这 些 接口 的 默认 实现 。 在 大 多 数 情况 

下 ， 为 应 用 程序 扩展 DefaultHandler 并 覆盖 相关 的 方法 要 比 直 接 实现 一 个 接口 更 容易 。 
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1. XMLReader 


为 注册 事件 处 理 器 并 启动 语法 分 析 器 ， 应 用 程序 使 用 XMLReader 接口 。 如 我 们 所 
，parse() 这 种 XMLReader 方法 ， 启 动 语 法 分 析 : 


m 


parser.parse (args[0]); 


XML Reader 的 主要 方法 如 下 。 

(1) parse): 对 XML 文档 进行 语法 分 析 。parse0 有 两 个 版 本 : 一 个 接受 文件 名 或 
URL， 另 一 个 接受 InputSource 对 象 。 

(2) setContentHandler(), setDTDHandler(). setEntityResolver()fil setErrorHandler(): il: 
应 用 程序 注册 事件 处 理 器 。 

(3) setFeature0 和 setProperty0: 控制 语法 分 析 器 如 何 工作 。 它 们 采用 一 个 特性 或 功能 
标识 (一 个 类 似 于 名 称 空间 的 URI 和 值 )。 功 能 采用 Boolean 值 ， 而 特性 采用 “对 象 ”。 

XMLReaderFactory 为 方便 创建 不 同 的 XMLReader 而 提供 ， 最 常用 的 
XMLReaderFactory 功能 如 下 。 

(1) http://xml.org/sax/features/namespaces: 所 有 SAX 语法 分 析 器 都 能 识别 它 。 如 果 将 
它 设置 为 true( 默 认 值 )， 则 在 调用 ContentHandler 的 方法 时 ， 语 法 分 析 器 将 识别 出 名 称 空间 
并 解析 前 级 。 

(2) http://xml.org/sax/features/validation: 它 是 可 选 的 。 如 果 将 它 设 置 为 tue， 则 验证 语 
法 分 析 器 将 验证 该 文档 。 非 验证 语法 分 析 器 忽略 该 功能 。 

2. XMLReaderFactory 


XMLReaderFactory 创建 语法 分 析 器 对 象 。 它 定义 createXMLReader() 的 两 个 版 本 : 
个 采用 语法 分 析 器 的 类 名 作为 参数 ， 另 一 个 从 org.xml.sax.driver 系统 特性 中 获得 类 名 称 。 
对 于 Xerces， 类 是 org.apache.xerces.parsers.SAXParser。 应 该 使 用 XMLReaderFactory， 
因为 它 易于 切换 至 另 一 种 SAX 语法 分 析 器 。 实 际 上 ， 只 需要 更 改 一 行 ， 然 后 重新 编译 。 
XMLReaderparser-XMLReaderFactory.createXMLReader ( 
"org.apache.xerces.parsers.SAXParser"); 


为 获得 更 大 的 灵活 性 ， 应 用 程序 可 以 从 命令 行 读 取 类 名 或 使 用 不 带 参数 的 
createXMLReader()。 因 此 ， 甚 至 可 以 不 重新 编译 就 更 改 语法 分 析 器 。 

3. InputSource 

InputSource 控制 语法 分 析 器 如 何 读 取 文件 ， 包 括 XML 文档 和 实体 。 在 大 多 数 情 况 
下 ,文档 是 从 URL 装 入 的 。 但 是 ， 有 特殊 需求 的 应 用 程序 可 以 覆盖 InputSource。 例 如 ， 
还 可 以 用 来 从 数据 库 中 装 入 文档 。 

4. ContentHandler 

ContentHandler 是 最 常用 的 SAX 接口 ， 因 为 它 定 义 了 XML 文档 的 事件 。ContentHandler 
声明 以 下 几 个 事件 。 

(1) startDocument()'endDocument(): 通知 应 用 程序 文档 的 开始 或 结束 。 

(2) startElement()/endElement(): 通知 应 用 程序 标记 的 开始 或 结束 。 属 性 作为 Attributes 
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参数 传递 (请 参阅 “5. 属性 ”小 节 )。 即 使 只 有 一 个 标记 ，“ 空 ”元 素 (例如 ，<imghre 仁 
"logo.gif'/>) 也 生成 startElement()fll endElement()。 

(3) startPrefixMapping()/endPrefixMapping(): 通知 应 用 程序 名 称 空间 作用 域 。 您 几乎 不 
需要 该 信息 ， 因 为 当 http://xml.org/sax/features/namespaces 为 true 时 ， 语 法 分 析 器 已 经 解析 
了 名 称 空间 。 

(4) characters()/ignorablewhitespace(): 当 语 法 分 析 器 在 元 素 中 发 现 文本 (已 经 过 语法 分 
析 的 字符 数据 ) 时 ，characters(J/ignorableWhitespace0 会 通知 应 用 程序 。 要 知道 ， 语 法 分 析 
器 负责 将 文本 分 配 到 几 个 事件 (更 好 地 管理 其 缓冲 区 )。ignorableWhitespace 事件 用 于 由 
XML 标准 定义 的 可 忽略 空格 。 

(5) processingInstruction(): 将 处 理 指令 通知 应 用 程序 。 

(6) skippedEntity( : 通知 应 用 程序 已 经 跳 过 了 一 个 实体 ( 即 ， 当 语法 分 析 器 未 在 
DTD/schema 中 发 现实 体 声明 时 )。 

(7) setDocumentLocator(): 将 Locator 对 象 传递 到 应 用 程序 ， 请 参阅 后 面 的 Locator 一 
节 。 请 注意 ， 不 需要 SAX 语法 分 析 器 提供 Locator， 但 是 如 果 它 提供 了 ， 则 必须 在 任何 其 
他 事件 之 前 激活 该 事件 。 

5. 属性 

在 startElement() 事 件 中 ， 应 用 程序 在 Attributes 参数 中 接收 属性 列表 。 

Stringattribute-attributes.getValue ("","price"); 

Attributes 定义 下 列 方法 。 

Q getValue(i)/getValue(qName)/getValue(uri.localName): 返回 第 i 个 属性 值 或 给 定名 

称 的 属性 值 。 

Q getLength(: 返回 属性 数目 。 

口 getQName(i)/getLocalName(i)getURI(): 返回 限定 名 ( 带 前 级 )、 本 地 名 (不 带 前 级 ) 
和 第 i 个 属性 的 名 称 空间 URI. 

口 ”getType(i)/getType(qName)/getType(uri,localName): 返回 第 i 个 属性 的 类 型 或 者 给 
定名 称 的 属性 类 型 。 类 型 为 字符 串 ， 即 在 DID 所 使 用 的 : CDATA, ID. 
IDREF , IDREFS , NMTOKEN 、NMTOKENS 、ENTITY 、ENTITIES 或 
NOTATION. 


GER: Attributes 参数 仅 在 startElement() 事 件 期 间 可 用 。 如 果 在 事件 之 间 需 要 它 ， 则 
用 AttributesImpl 复制 一 个 。 
6. 定位 器 
Locator 为 应 用 程序 提供 行 和 列 的 位 置 。 不 需要 语法 分 析 器 来 提供 Locator 对 象 。 
Locator 定义 下 列 方法 。 
OQ getColumnNumber(): 返回 当前 事件 结束 时 所 在 的 那 一 列 。 在 endElement0 事 件 
中 ， 它 将 返回 结束 标记 所 在 的 最 后 一 列 。 
Q getLineNumber(): 返回 当前 事件 结束 时 所 在 的 行 。 在 endElement() 事 件 中 ， 它 将 
返回 结束 标记 所 在 的 行 。 
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Q getPublicld): 返回 当前 文档 事件 的 公共 标识 。 
口 ”getSystemId(): 返回 当前 文档 事件 的 系统 标识 。 


7. DTDHandler 


DTDHandler 声明 两 个 与 DTD 语法 分 析 器 相关 的 事件 。 具 体 如 下 。 
Q  notationDecl): 通知 应 用 程序 已 经 声明 了 一 个 标记 。 
Q nparsedEntityDecl(): 通知 应 用 程序 已 经 发 现 了 一 个 未 经 过 语法 分 析 的 实体 声明 。 


8. EntityResolver 


EntityResolver 接口 仅 定义 一 个 事件 resolveEntity0， 它 返回 InputSource( 在 另 一 章 将 讨 
论 )。 因 为 SAX 语法 分 析 器 已 经 可 以 解析 大 多 数 URL， 所 以 很 少 有 应 用 程序 实现 
EntityResolver。 例 外 情况 是 目录 文件 (在 另 一 章 中 讨论 )， 它 将 公共 标识 解析 成 系统 标识 。 
如 果 在 应 用 程序 中 需要 目录 文件 ， 请 下 载 NormanWalsh 的 目录 软件 包 ( 请 参阅 参考 资料 )。 

9. ErrorHandler 

ErrorHandler 接口 定义 错误 事件 。 处 理 这 些 事件 的 应 用 程序 可 以 提供 定制 错误 处 理 。 
安装 了 定制 错误 处 理 器 后 ， 语 法 分 析 器 不 再 抛 出 异常 。 抛 出 异常 是 事件 处 理 器 的 责任 。 
ErrorHandler 接口 定义 了 与 错误 的 三 个 级 别 或 严重 性 对 应 的 方法 。 

O waming): 警示 那些 不 是 由 XML 规范 定义 的 错误 。 例 如 ， 当 没有 XML 声明 时 ， 

某 些 语法 分 析 器 发 出 警告 。 它 不 是 错误 (因为 声明 是 可 选 的 )， 但 是 它 可 能 值得 
注意 。 

Q error(): 警示 那些 由 XML 规范 定义 的 错误 。 

Q ”fatalError(): 警示 那些 由 XML 规范 定义 的 致命 错误 。 

10. SAXException 

SAX 定义 的 大 多 数 方法 都 可 以 抛 出 SAXException。 当 对 XML 文档 进行 语法 分 析 时 ， 
SAXException 通知 一 个 错误 。 错 误 可 以 是 语法 分 析 错 误 也 可 以 是 事件 处 理 器 中 的 错误 。 要 
想 报告 来 自 事件 处 理 器 的 其 他 异常 ， 可 以 将 异常 封装 在 SAXException 中 。 


9.3 开发 一 个 RSS 订阅 程序 


在 使 用 RSS 订阅 时 ， 常 常 通过 网 站 提供 的 “订阅 RSS” 连 接 或 小 图 标 实现 ， 当 单 击 连 
接 后 ， 会 弹出 包含 RSS 内 容 的 页 面 ， 此 页 面 的 网 址 是 网 站 的 RSS 网 址 。 当 连接 到 这 个 网 
址 后 ， 服 务 器 端 会 返回 RSS 标准 规格 的 XML 文件 ， 只 要 按照 统一 格式 来 解析 XML X 
件 ， 就 可 以 得 到 RSS 内 的 相关 信息 。 本 节 将 通过 一 个 具体 实例 的 实现 过 程 ， 讲 解 在 
Android 系统 中 开发 一 个 RSS 项 目的 基本 过 程 。 


实例 | 功 能 源码 路 径 
实例 9-1 | 开发 一 个 RSS 系统 下 载 路 径 :\daima\9\RSSC 


> Andid sssannsmia 


在 本 实例 中 ， 用 户 只 需要 输入 一 个 RSS feed 网 址 ， 通 过 SAX Parser 解析 后 就 可 以 直 
接 在 手机 上 浏览 在 线 实 时 新 闻 。 本 实例 的 具体 实现 流程 如 下 。 


9.3.1 实现 界面 布局 文件 


(1) 编写 主 布局 文件 main.xml， 上 方 显示 文字 “设置 RSS 连接 ”， 中 间 显 示 一 个 可 输 
入 文本 框 ， 下 方 显示 一 个 按钮 。 主 要 代码 如 下 : 


<EditText 
android:id="@+id/myEdit" 
android:layout_width="280px" 
android:layout height="wrap content" 
android:text="http://" 
android:textSize="12sp" 
android:layout x="20px" 
android:layout y="42px" 

> 

</EditText> 

<TextView 
android: id="@+id/myText" 
android:layout width="wrap content" 
android: layout height-"wrap content" 
android:text="@string/str title" 
android: textColor="@drawable/black" 
android: textSize="1l6sp" 
android:layout x="20px" 
android:layout y="12px" 

> 

</TextView> 

<Button 
android: id="@+id/myButton" 
android:layout width="86px" 
android:layout height="46px" 
android: text="@string/str_button" 
android: textColor="@drawable/black" 
android:layout x="100px" 
android: layout y="112px" 

> 

</Button> 


(2) 编写 布局 文件 newslist.xml， 在 里 面 设置 了 一 个 ListView 控件 ， 用 于 列表 显示 获取 
的 RSS 信息 标题 。 主 要 代码 如 下 : 


<TextView 
android:id="@+id/myText" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:padding-"5px" 
android:textSize-"18sp" 
android:textColor-"(drawable/blue" 
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> 

</TextView> 

<ListView 
android: id="@android:id/list"” 
android: layout_width="wrap_ content" 
android:layout height="wrap content" 

> 

</ListView> 


(3) 编写 布局 文件 news_row.xml， 在 其 中 设置 一 个 TextView 控件 ， 用 于 显示 某 一 条 
RSS 信息 。 主 要 代码 如 下 : 


<ImageView android:id="@+id/icon" 
android:layout width="20dip" 
android: layout height-"20dip" 
android: src="@drawable/news" 

> 

</ImageView> 

<TextView android: id="@+id/text" 
android:layout gravity="center vertical” 
android:layout width="wrap content" 
android:layout height="wrap content" 
android: textColor="@drawable/black" 

> 

</TextView> 


(4) 编写 布局 文件 newscontent.xml， 在 其 中 设置 三 个 TextView 控件 ， 用 于 显示 某 条 
RSS 信息 的 详细 内 容 。 主 要 代码 如 下 : 


<TextView 
android:id="@+id/myTitle" 
android:layout width="300px" 
android:layout height="wrap content" 
android:textSize="16sp" 
android:layout x="10px" 
android:layout y="12px" 
android:textColor="@drawable/blue" 

> 

</TextView> 

<TextView 
android:id="@+id/myDesc" 
android:layout width="300px" 
android:layout height="120px" 
android:layout x="10px" 
android:layout y="70px" 
android:textColor="@drawable/black" 


zd 

«/TextView» 

<TextView 
android: id="@+id/myLink" 
android:layout width="300px" 
android: layout_height="wrap content" 
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android:layout x="10px" 
android:layout y-"210px" 
D 
</TextView> 


9.32 ”实现 主 程序 文件 


(1) 编写 主 程序 文件 RSSC.java， 功 能 是 以 EditText 来 作为 输入 RSS 连接 组 件 ， 当 输 
入 网 址 后 ， 单 击 “ 解 析 ” 按 钮 后 ， 按 钮 的 onClick 会 被 触发 ， 运 行 EditText 的 空白 检查 。 
当 检 查 无 误 后 ， 将 输入 的 网 址 写 入 Bundle 对 象 中 ， 再 将 Bundle 对 象 assign 给 Intent, JF 
过 startActivityForResult() 来 触发 RSSC_1 这 个 Activity。 文 件 RSSC java 的 实现 代码 如 下 : 


package irdc.RSSC; 


/* import 相关 class */ 

import irdc.RSSC.R; 

import android.app.Activity; 

import android.app.AlertDialog; 

import android.content.DialogInterface; 
import android.content.Intent; 

import android.os.Bundle; 

import android.view.View; 

import android.widget.Button; 

import android.widget.EditText; 


public class RSSC extends Activity 
{ 

/* 变量 声明 */ 

private Button mButton; 

private EditText mEditText; 


GOverride 
public void onCreate (Bundle savedInstanceState) 
t 
super.onCreate (savedInstanceState); 
setContentView (R.layout.main); 
/* 初始 化 对 象 */ 
mEditText-(EditText) findViewById(R.id.myEdit) ; 
mButton- (Button) findViewById (R.id.myButton); 
/* WE Button [f] onclick 事件 */ 
mButton.setOnClickListener(new Button.OnClickListener() 
t 
Goverride 
public void onClick(View v) 
t 
String path-mEditText.getText ().toString(); 
if (path.equals("") ) 
{ 
showDialog ("网 址 不 可 为 空白 !"); 


OB& 9$ 在 Android 中 开发 RSS 应 用 


} 
else 


{ 
/* new 一 个 Intent 对 象 ， 并 指定 class */ 
Intent intent = new Intent(); 
intent.setClass(RSSC.this,RSSC 1.class); 


/* new —^ Bundle 对 象 ， 并 将 要 传递 的 数据 传 入 */ 
Bundle bundle = new Bundle(); 
bundle.putString("path", path) ; 

/* ¥§ Bundle 3l € assign 47 Intent */ 

intent .putExtras (bundle); 

/* iF Activity RSSC 1 */ 
startActivityForResult (intent,0); 


); 


/* imi onActivityResult()*/ 
@override 
protected void onActivityResult (int requestCode,int resultCode, 
Intent data) 
{ 
switch (resultCode) 
{ 
case 99: 
/* 返回 错误 时 以 Dialog 显示 */ 
Bundle bunde = data.getExtras(); 
String error = bunde.getString("error"); 
showDialog (error); 
break; 
default: 
break; 


} 


/* 显示 Dialog 的 方法 */ 
private void showDialog(String mess) { 
new AlertDialog.Builder (RSSC.this) .setTitle ("Message") 
-setMessage (mess) 
.SetNegativeButton ("确定 ",，new DialogInterface.OnClickListener() 
{ 
public void onClick(DialogInterface dialog, int which) 
t 
} 
) 
-show(); 
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(2) 编写 文件 RSSC_1java， 此 文件 是 一 个 ListActivity， 是 通过 主 程序 RSSC java 来 调 
用 的 ， 用 于 显示 订阅 的 RSS 内容 列表 。 其 实现 流程 如 下 。 
® 引用 相关 class， 分 别 声明 变量 TextView mText、title 和 1i。 具 体 代码 如 下 : 


package irdc.RSSC; 


/* import 相关 class */ 
import irdc.RSSC.R; 


import java.net.URL; 

import java.util.ArrayList; 
import java.util.List; 

import android.app.ListActivity; 
import android.content.Intent; 
import android.os.Bundle; 
import android.view.View; 
import android.widget.ListView; 
import android.widget.TextView; 
import javax.xml.parsers.*; 
import org.xml.sax.InputSource; 
import org.xml.sax.XMLReader; 


public class RSSC 1 extends ListActivity 
{ 
/* 变量 声明 */ 
private TextView mText; 
private String title-""; 
private List«News» li-new ArrayList<News>(); 


© 设置 layout 为 newslist.xml， 取 得 Intent 中 的 Bundle 对 象 ， 并 取得 Bundle 对 象 中 
的 数据 ， 然 后 调用 getRssO 取 得 解析 后 的 List。 有 具体 代码 如 下 : 


GOverride 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
/* W'E layout Àj newslist.xml */ 
setContentView (R.layout.newslist); 


mText-(TextView) findViewById (R.id.myText); 
/* 取得 Intent 中 的 Bundle WR */ 

Intent intent=this.getIntent (); 

Bundle bunde = intent.getExtras(); 

/* 取得 Bundle 对 象 中 的 数据 */ 

String path = bunde.getString ("path"); 
/* 调用 getRss () 取得 解析 后 的 List */ 
li=getRss (path); 

mText.setText (title); 

/* 设置 自 定义 的 MyAdapter */ 
setListAdapter (new MyAdapter (this,1i)); 
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图 定义 onListItemClick， 定 义 监听 Listltem 被 点 击 时 要 做 的 动作 。 先 获取 News 对 
象 ， 新 建 一 个 Intent 对 象 ， 并 指定 其 class， 然 后 新 建 一 个 Bundle 对 象 ， 并 将 要 传递 的 数据 
传 入 ， 接 着 将 Bundle 对 象 assign 给 Intent， 最 后 调用 Activity RSSC 2。 具体 代码 如 下 : 
/* 设置 ListItem 被 点 击 时 要 做 的 动作 */ 
@override 


protected void onListItemClick(ListView 1,View v,int position, 
long id) 


{ 
/* 取得 News 对 象 */ 
News ns-(News)li.get (position); 
/* new —^ Intent 对 象 ， 并 指定 class */ 
Intent intent - new Intent(); 
intent.setClass(RSSC 1.this,RSSC 2.class); 
/* new —^ Bundle 对 象 ， 并 将 要 传递 的 数据 传 入 */ 
Bundle bundle = new Bundle(); 
bundle.putString("title",ns.getTitle()); 
bundle.putString ("desc",ns.getDesc()); 
bundle. putString ("link",ns.getLink()); 
/* ¥ Bundle X4 € assign 4 Intent */ 
intent .putExtras (bundle); 
/* 调用 Activity RSSC 2 */ 
startActivity (intent) ; 

} 


@ 定义 方法 getRss(String path) 来 解析 XML。 有 具体 代码 如 下 : 


/* 解析 XML 的 方法 */ 
Private List<News> getRss (String Path) 
t 
List<News> data-new ArrayList«News»(); 
URL url - null; 
try 
t 
url - new URL(path); 
/* 产生 SAXParser 对 象 */ 
SAXParserFactory spf = SAXParserFactory.newInstance(); 
SAXParser sp = spf.newSAXParser(); 
/* 产生 XMLReader 对 象 */ 
XMLReader xr = sp.getXMLReader (); 
/* 设置 自 定 义 的 MyHandler 给 XMLReader */ 
MyHandler myExampleHandler = new MyHandler(); 
xr.setContentHandler (myExampleHandler) ; 
/* 解析 XML */ 
xr.parse(new InputSource (url.openStream())); 
/* 取得 RSS 标题 与 内 容 列 表 */ 
data -myExampleHandler.getParsedData(); 
title-myExampleHandler.getRssTitle(); 
H 


O 如 果 有 蜡 常 则 输出 错误 提示 对 话 框 ， 具 体 代码 如 下 : 
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catch (Exception e) 

t 
/* 发 生 错误 时 返回 result 到 上 一 个 activity */ 
Intent intent-new Intent (); 
Bundle bundle = new Bundle(); 
bundle. putString (Terror",""te); 
intent.putExtras (bundle); 
/* 错误 的 返回 值 设置 为 99 */ 
RSSC 1.this.setResult (99, intent); 
RSSC 1.this.finish(); 

} 

return data; 


(3) 编写 文件 RSSC_2.java， 此 Activity 由 RSSC 1 唤起 ， 用 于 显示 上 一 个 Activity 所 
点 击 的 新 闻 内 容 。 当 程序 被 唤起 后 ， 首 先 会 从 Bundle 对 象 中 获取 News 的 title, link 和 
desc， 并 显示 在 画面 中 。 并 以 Linkify.addLinks() link 设置 为 一 个 WEB URLS 形式 的 链 
接 。 当 用 户 点 击 链接 后 ， 会 通过 设置 的 网 址 直接 打开 Web 浏览 器 来 浏览 网 页 。 其 具体 实现 
代码 如 下 : 


package irdc.RSSC; 


/* import 相关 class */ 

import irdc.RSSC.R; 

import android.app.Activity; 
import android.content.Intent; 
import android.os.Bundle; 

import android.text.util.Linkify; 
import android.widget.TextView; 


public class RSSC 2 extends Activity 
{ 

/* 变量 声明 */ 

private TextView mTitle; 

private TextView mDesc; 

private TextView mLink; 


@override 
public void onCreate (Bundle savedInstanceState) 
{ 
super .onCreate (savedInstanceState) ; 
/* 设置 layout Jj newscontent.xml */ 
setContentView (R. layout .newscontent) ; 
/* 初始 化 对 象 */ 
mTitle-(TextView) findViewById(R.id.myTitle) ; 
mDesc-(TextView) findViewById(R.id.myDesc) ; 
mLink-(TextView) findViewById(R.id.myLink) ; 


/* 取得 Intent 中 的 Bundle WR */ 
Intent intent-this.getIntent(); 
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Bundle bunde = intent.getExtras(); 

/* Wf Bundle 对 象 中 的 数据 */ 

mTitle.setText (bunde.getString("title")); 
mDesc.setText (bunde.getString("desc")+"...."); 
mLink.setText (bunde.getString ("link") ); 

/* 设置 mLink 为 网 页 连接 */ 

Linkify.addLinks (mLink,Linkify.WEB URLS); 


) 


(4) 编写 文件 Newsjava， 在 此 定义 了 一 个 JavaBean 类 ， 用 于 存放 每 一 篇 新 闻 信息 。 
每 一 个 News 对 象 代表 了 一 条 新 闻 ， 在 News 对 象 中 定义 了 新 闻 的 标题 、 描 述 、 网 站 链接 
和 发 布 时 间 4 个 属性 。JavaBean 类 中 的 方法 都 是 以 setAAAQA getAAA() 方 式 来 命名 的 ， 
所 以 用 setAAA() 来 设置 属性 值 ， 或 通过 getAAA() 来 获取 属性 值 。 具 体 代 码 如 下 : 


package irdc.RSSC; 


public class News 

{ 
/* 新 建 变量 初始 值 为 空 */ 
private String title-"" 
private String link="" 
private String desc=""; 
private String date=""; 


public String getTitle() 
{ 
return title; 
5 
public String getLink() 
t 
return link; 
} 
public String getDesc() 
t 
return desc; 
} 
public String getDate() 
{ 
return date; 
} 
public void setTitle(String title) 
{ 
title=title; 
} 
public void setLink(String link) 
{ 
link-link; 
5 
public void setDesc(String desc) 
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desc-desc; 


} 
public void setDate(String date) 


t 
. date-date; 


} 
} 
(5) 编写 文件 MyAdapterjava ， 在 此 定义 了 Adapter 对 象 ， 它 继承 自 
android.widgetBaseAdapter， 用 于 设置 ListView 中 要 显示 的 信息 ， 以 news row.xml 作为 
Layout。 具 体 代码 如 下 : 


package irdc.RSSC; 


/* import 相关 class */ 
import irdc.RSSC.R; 


import java.util.List; 

import android.content.Context; 
import android.view.LayoutInflater; 
import android.view.View; 

import android.view.ViewGroup; 
import android.widget.BaseAdapter; 
import android.widget.TextView; 


/* 自 定义 的 Rdapter， 继 承 android.widget.BaseAdapter */ 
public class MyAdapter extends BaseAdapter 
t 

/* 变量 声明 */ 

private LayoutInflater mInflater; 

private List«News» items; 


/* MyAdapter 的 构造 器 ， 传 递 两 个 参数 */ 
public MyAdapter(Context context,List<News> it) 


t 
/* 参数 初始 化 */ 
mInflater = LayoutInflater.from(context); 
items - it; 

) 


/* 因 继 承 BaseAdapter， 需 重 写 以 下 方法 */ 
GOverride 
public int getCount () 
{ 
return items.size(); 


GOverride 
public Object getItem(int position) 
{ 

return items.get (position) ; 
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@override 
public long getItemId(int position) 
{ 
return position; 
} 


@override 
public View getView(int position,View convertView, ViewGroup par) 
{ 

ViewHolder holder; 


if (convertView == null) 
{ 
/* 使 用 自 定义 的 news_row EJ Layout */ 
convertView - mInflater.inflate(R.layout.news row, null); 
/* 初始 化 holder hj text 5; icon */ 
holder = new ViewHolder(); 
holder.text = (TextView) convertView.findViewById (R.id.text); 
convertView.setTag (holder); 


) 
else 


t 

holder = (ViewHolder) convertView.getTag(); 
) 
News tmpN= (News) items.get (position); 
holder.text.setText (tmpN.getTitle()); 


return convertView; 


/* class ViewHolder */ 
private class ViewHolder 
{ 

TextView text; 


j 


(6) 编写 文件 MyHandlerjava ， 在 此 定义 了 MyHandler 对 象 ， 它 继承 自 
org.xml.sax.helpers.DefaultHandler， 用 于 解析 XML 文件 ， 并 获取 对 应 的 信息 。 下 面 开 始 讲 
解 文件 MyHandlerjava 的 具体 实现 流程 。 

© 引入 相关 class， 然 后 分 别 声明 各 个 变量 。 具 体 代码 如 下 : 


package irdc.RSSC; 


/* import 相关 class */ 

import java.util.ArrayList; 
import java.util.List; 

import org.xml.sax.Attributes; 
import org.xml.sax.SAXException; 
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import org.xml.sax.helpers.DefaultHandler; 


public class MyHandler extends DefaultHandler 
t 

/* 变量 声明 */ 

private boolean in item = false; 

private boolean in title = false; 

private boolean in link = false; 

private boolean in desc = false; 

private boolean in date = false; 

private boolean in mainTitle = false; 

private List<News> 1i; 

private News news; 

private String title=""; 

private StringBuffer buf-new StringBuffer(); 


Q) 分 别 将 转换 成 List<News> 的 XML 数据 和 解析 出 的 RSS tide 返回 ， 然 后 调用 
startDocument()， 开 始 解析 操作 。 当 解析 结束 时 ， 调 用 endDocument()。 当 解析 到 Element 
开头 时 ， 调 用 startElement 方法 。 具 体 代码 如 下 : 


/* 将 转换 成 List<News> 的 xML 数据 返回 */ 
public List<News> getParsedData() 
{ 

return li; 


} 
/* 将 解析 出 的 RSS title 返回 */ 
public String getRssTitle() 
{ 

return title; 


} 
/* XML 文件 开始 解析 时 调用 此 方法 */ 
@override 
public void startDocument () throws SAXException 
{ 
li = new ArrayList<News>(); 


} 
/* XML 文件 结束 解析 时 调用 此 方法 */ 
@override 
public void endDocument () throws SAXException 
{ 
5 
/* 解析 到 Element 的 开头 时 调用 此 方法 */ 
@override 
public void startElement (String namespaceURI, String localName, 
String qName, Attributes atts) throws SAXException 
{ 
if (localName.equals ("item") ) 
{ 
this.in item = true; 
/* 解析 到 item 的 开头 时 new 一 个 News WR */ 


news-new News(); 
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} 
else if (localName.equals ("title")) 
{ 
if(this.in item) 
{ 
this.in title = true; 
} 
else 
{ 
this.in mainTitle = true; 


} 
else if (localName.equals ("link") ) 
{ 
if (this.in item) 
{ 
this.in link = true; 


} 
else if (localName.equals ("description") ) 
{ 
if (this.in item) 
{ 
this.in desc = true; 


} 
else if (localName.equals ("pubDate")) 
t 
if(this.in item) 
t 
this.in date - true; 


} 
© 当 解 析 到 Element 的 结尾 时 调用 endElement 方法 ， 具 体 代码 如 下 : 
/* 解析 到 Element 的 结尾 时 调用 此 方法 */ 


@override 
public void endElement (String namespaceURI, String localName, 
String qName) throws SAXException 
t 
if (localName.equals ("item")) 
t 
this.in item — false; 
/* 解析 到 item 的 结尾 时 将 News HRSA List 中 */ 
li.add (news); 
} 
else if (localName.equals ("title") ) 
t 
if(this.in item) 
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/* WH News WRN title */ 
news.setTitle(buf.toString().trim()); 
buf.setLength(0); 
this.in title = false; 
} 
else 
{ 
/* RE Rss i title */ 
title-buf.toString().trim(); 
buf .setLength (0); 
this.in mainTitle = false; 
} 
5 
else if (localName.equals ("link") ) 
{ 
if (this.in item) 
{ 
/* 设置 News MRM link */ 
news.setLink (buf.toString() .trim()); 
buf.setLength (0) ; 
this.in link = false; 
} 
} 
else if (localName.equals ("description")) 
t 
if(in item) 
t 
/* 设置 News XII description */ 
news.setDesc(buf.toString().trim()); 
buf.setLength (0); 
this.in desc - false; 
} 
} 
else if (localName.equals ("pubDate")) 
{ 
if (in item) 
{ 
/* 设置 News 对 象 的 pubDate */ 
news.setDate (buf.toString().trim()); 
buf.setLength (0); 
this.in date - false; 


) 
@ 定义 方法 characters 来 获取 Element 开头 和 结尾 中 间 的 字符 串 ， 有 具体 代码 如 下 : 
/* 取得 Element 的 开头 和 结尾 中 间 的 字符 串 */ 


@override 
public void characters(char ch[], int start, int length) 
{ 

if (this.in item||this.in mainTitle) 


OB« 9$ 在 Android 中 开发 RSS 应 用 


t 
/* 将 char[] 添 加 StringBuffer */ 
buf.append (ch, start, length) ; 

} 


} 


执行 后 的 效果 如 图 9-3 所 示 。 在 文本 框 中 输入 RSS 网 址 http://rss.sina.com.cn/news/ 
marquee/ddt.xml， 然 后 单 击 “ 解 析 ” 按 钮 ， 会 在 屏幕 中 列表 显示 RSS 新 闻 ， 如 图 9-4 所 
示 。 单 击 某 条 新 闻 后 ， 会 显示 此 新 闻 的 简介 ， 如 图 9-5 所 示 。 单 击 简介 下 面 的 链接 后 会 显 
示 此 RSS 的 详细 信息 ， 如 图 9-6 所 示 。 


新 闻 中 心 
P RANOR 48 EBARA MEENA 
1 ) 


7? (APRA ACA ELE HEY B OY RO E 
10/14 16:57) 

p IBSTER AE URRETERGE CR i 
(10/14 16:56) 

s ORS RAR M GM GER AIR 
油 10114 16:54) 

7 [国际 ] 夫 全 总 理 贡 拉 因 洪 灾 可 能 取消 访 华 计 
3810/14 16:44) 

设置 RS5 连 接 ; 六 国内) 中国 空军 未 派 飞机 参加 通航 大 会 飞行 表 

(10/14 16:41) 

P IHHÜRENZHSXURKRHAQON 
7410/14 16:31) 

P (GREER PLAITOPIO : MOGE 
首 (10/14 15:59) 

+ [ER] Re 35 MA OBR 33 P E OA AR 
nmm (10/14 15:57) 

解析 户 | 村 摘 ] 刘 海 淹 : 共 性 平台 + 应 用 子 集成 物 联网 发 展 机 
式 (10/14 15:57) 

ti bare ATRAER 
无 法 预知 (10114 15:45) 

Le (MIR AT 8:100 cT CL EI PENNEN 


图 9-3 执行 效果 图 9-4 RSS 列 表 


http://finance.sina.co… O X 


[股市 ]10 月 14 日 上 市 公司 晚间 公告 速 
递 (10/14 16:58) 


新 浪 财经 讯 10 月 14 日 晚间 ， 沪 深 两 市 多 家 
上 市 公司 发 布 了 公告 。 以 下 是 公告 摘要 : 


深圳 证 券 交 易 所 


(000679) 大 连 友谊 : 第 六 届 董 事 会 第 九 次 会 
议决 议 


com.cn/redirect. php?uri=http: 
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9.4 开发 一 个 RSS 阅读 器 


从 本 节 内 容 开 始 ， 将 着 重 
过 程 ， 并 讲解 其 中 的 技巧 和 要 


介绍 本 项 目的 具体 实现 过 程 。 详 细 讲解 各 个 代码 的 具体 实现 
点 ， 使 读者 的 水 平 更 上 一 层 楼 。 


实例 9-2 开发 一 个 RSS 阅读 器 下 载 路 径 :\daima\9\RSSREAD 


9.4.1 建立 实体 类 


-个 RSS 文件 可 以 被 认为 是 由 一 个 RSS 的 一 些 描 述 性 信息 和 里 面 的 item 元 素 组 成 

的 ， 例 如 下 面 关 于 RSS 的 描述 性 信息 。 

O tte: 标题 信息 。 

Q link: 链接 信息 。 

Q description: 描述 信息 。 

item 中 的 信息 如 下 。 

Q title: 标题 信息 。 

口 link: 链接 信息 。 

口 description: 描述 信息 。 

口 pubDate: 发 布 的 日 期 。 

在 本 项 目 实例 中 需要 建立 以 下 两 个 实体 类 。 

口 RSSFeed: 用 于 和 一 个 RSS 的 完整 XML 文件 相对 应 。 

口 RSSItem: 用 于 和 一 个 RSS 中 的 Item 标签 相对 应 。 

在 解析 RSS 文件 时 ， 可 以 将 文件 里 的 信息 解析 出 来 放 到 实体 类 中 ， 这 样 就 可 以 直接 操 
作 该 实体 类 了 。 下 面 开始 讲解 上 述 两 个 实体 类 的 具体 实现 过 程 。 

1. RSSFeed 类 

RSSFeed 类 的 功能 是 ， 建 立 和 一 个 完整 XML 文件 的 对 应 ， 其 中 方法 addItem 用 于 将 
一 个 RSSItem 添加 到 RSSFeed 类 中 ; 方法 getAllItemsForListView 负责 从 RSSFeed 类 中 生 
成 ListView 列表 所 需要 的 数据 。RSSFeed 类 的 具体 实现 代码 如 下 : 

package com.rss reader.data; 

import java.util.ArrayList; 

import java.util.HashMap; 

import java.util.List; 


import java.util.Map; 
import java.util.Vector; 


public class RSSFeed 
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private String title = null; 
private String pubdate - null; 
private int itemcount - 0; 
private List<RSSItem> itemlist; 


public RSSFeed () 
{ 
itemlist = new Vector (0); 
} 
public int addItem(RSSItem item) 
{ 
itemlist.add (item); 
itemcount++; 
return itemcount; 
} 
public RSSItem getItem(int location) 
{ 
return itemlist.get (location) ; 
} 
public List getAllItems() 
t 
return itemlist; 
) 
public List getAllItemsForListView() { 
List<Map<String, Object>> data = new ArrayList<Map<String, Object>>(); 
int size = itemlist.size(); 
for(int i=0;i<size; i++) { 
HashMap<String, Object>item = new HashMap<String, Object>(); 
item.put (RSSItem.TITLE, itemlist.get (i) .getTitle()); 
item.put (RSSItem.PUBDATE, itemlist.get (i) .getPubDate()); 
data.add (item); 
) 
return data; 


int getItemCount () 
{ 
return itemcount; 

public void setTitle(String title) 
this.title = title; 

public void setPubDate (String pubdate) 
this.pubdate = pubdate; 


public String getTitle() 


return title; 
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public String getPubDate() 
t 


return pubdate; 


) 


2. RSSltem 类 


RSSItem 类 的 功能 是 ， 用 于 和 一 个 RSS 中 的 Item 标签 相对 应 ， 其 中 的 属性 和 item 中 
的 属性 一 样 。RSSItem 类 的 具体 实现 代码 如 下 : 


package com.rss reader.data; 


public class RSSItem 
i 
public static final String TITLE-"title"; 
public static final String PUBDATE-"pubdate"; 
private String title = null; 
private String description - null; 
private String link - null; 
private String category - null; 
private String pubdate - null; 


public RSSItem() 
{ 
) 
public void setTitle(String title) 
{ 
this.title = title; 


public void setDescription(String description) 
{ 
this.description = description; 


public void setLink(String link) 
{ 
this.link = link; 


public void setCategory(String category) 
{ 
this.category = category; 


public void setPubDate (String pubdate) 
{ 
this.pubdate = pubdate; 


public String getTitle() 


9.4.2 
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return title; 
public String getDescription() 
return description; 
public String getLink() 
return link; 
public String getCategory() 
return category; 
public String getPubDate() 


t 
return pubdate; 


public String toString() 

{ 
if (title.length() > 20) 
{ 


} 
return title; 


主 程序 文件 ActivityMain.java 
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return title.substring(0, 42) + "..."; 


主 程序 文件 ActivityMainjava 是 本 项 目的 入 口 ， 在 此 Activity 中 得 到 了 服务 器 端的 
RSSFeed， 经 过 解析 后 将 其 中 的 内 容 以 ListView 的 形式 列表 显示 。 下 面 讲解 其 具体 实现 


流程 。 


(1) 先 引入 相关 class 类 ， 然 后 设置 目标 RSS 的 源 地 址 为 http://feed.feedsky.com/ 


woshiyigebing12345， 最 后 通过 showListView() 方 法 将 获取 的 RSS 信息 以 列表 形式 显示 出 
来 。 具 体 代码 如 下 : 


package com.rss reader; 


import java.net.URL; 


import javax.xml.parsers.SAXParser; 
import javax.xml.parsers.SAXParserFactory; 


import org.xml.sax.InputSource; 
import org.xml.sax.XMLReader; 


import android.app.Activity; 
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import android.content.Intent; 

import android.os.Bundle; 

import android.view.View; 

import android.widget .AdapterView; 

import android.widget.ListView; 

import android.widget .SimpleAdapter; 

import android.widget .AdapterView.OnItemClickListener; 


import com.rss reader.data.RSSFeed; 
import com.rss reader.data.RSSItem; 
import com.rss reader.sax.RSSHandler; 


public class ActivityMain extends Activity implements 
OnItemClickListener 


{ 
// public final String RSS URL = "http://rubyjin.cn/blog/rss"; 


public final String RSS URL = 
" http://feed. feedsky.com/woshiyigebing12345"; 


public final String tag = "RSSReader"; 
private RSSFeed feed = null; 


/** Called when the activity is first created. */ 


public void onCreate(Bundle icicle) { 
super.onCreate (icicle); 
setContentView (R.layout.main) ; 
feed = getFeed(RSS URL); 
showListView(); 


} 


(2) 定义 方法 getFeed(String urlString)， 用 于 得 到 一 个 RSSFeed， 即 从 服务 器 端 请 求 了 
RSS feed， 并 进行 了 解析 ， 将 解析 后 的 内 容 都 放 在 RSSFeed 的 一 个 实例 中 。 上 述 解析 过 程 
是 通过 SAX 实现 的 ， 具 体 流 程 如 下 。 

© 新 建 工厂 类 SAXParserFactory。 

Q) 工厂 类 产生 一 个 SAX 解析 类 SAXParser。 

@ 从 SAXParser 中 得 到 一 个 XMLReader 实例 ，XMLReader 是 一 个 接口 ， 此 接口 中 定 
义 了 一 些 解 析 XML 的 回调 函数 。 

@ 把 编写 的 Handler 注册 到 XMLReader 中 去 。 

© 将 一 个 XML 文档 或 资源 变 成 一 个 Java 可 以 处 理 的 InputStream 流 后 ， 解 析 工 作 
开始 。 

方法 getFeed(String urlString) 的 具体 代码 如 下 : 

private RSSFeed getFeed(String urlString) 


t 
try 
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URL url = new URL(urlString); 
/+ 新 建 工厂 类 SAXParserFactory*/ 
SAXParserFactory factory = SAXParserFactory.newInstance(); 
/* 工 厂 类 产生 一 个 SAX 解析 类 SAXParser */ 
SAXParser parser = factory.newSAXParser(); 
/* 从 SAXParser 中 得 到 一 个 XMLReader 实例 */ 
XMLReader xmlreader = parser.getXMLReader(); 
/* 把 编写 的 Handler 注册 到 XMLReader 中 */ 
RSSHandler rssHandler = new RSSHandler(); 
xmlreader.setContentHandler (rssHandler); 


/*34—^* XML 文档 或 资源 变 成 一 个 Java 可 以 处 理 的 InputStream 流 后 ， 解 析 工 作 开始 。*/ 


InputSource is = new InputSource (url.openStream()); 
xmlreader.parse (is); 


return rssHandler.getFeed(); 
) 
catch (Exception ee) 
t 


return null; 
) 
) 


(3) 定义 方法 showListView0 来 列表 显示 获取 的 RSS, 3X FÉ ListView 和 一 个 
SimpleAdapter 实现 了 绑 定 。 有 具体 代码 如 下 : 


private void showListView() 
{ 
ListView itemlist = (ListView) findViewById(R.id.itemlist) ; 
if (feed == null) 
{ 
setTitle ("访问 的 RSS LAL") ; 
return; 
} 
SimpleAdapter adapter = new SimpleAdapter (this, 
feed.getAllItemsForListView(), 
android.R.layout.simple list item 2, new String[] 
( RSSItem.TITLE,RSSItem.PUBDATE ), 
new int[] ( android.R.id.textl , android.R.id.text2]); 
itemlist.setAdapter (adapter); 
itemlist.setOnItemClickListener (this); 
itemlist.setSelection (0); 


} 


(4) 定义 方法 onItemClick， 用 于 处 理 列表 的 单 击 事件 ， 当 单 击 后 会 显示 此 RSS 信息 的 
后 可 以 通过 浏览 器 来 到 目标 地 址 。 具 体 代码 如 下 : 
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public void onItemClick (AdapterView parent, View v, int position, long id) 
t 
Intent itemintent = new Intent (this,ActivityShowDescription.class); 


Bundle b - new Bundle(); 

b.putString("title", feed.getItem(position) .getTitle()); 
b.putString("description", feed.getItem(position).getDescription()); 
b.putString("link", feed.getItem(position) .getLink()); 
b.putString("pubdate", feed.getItem(position) .getPubDate ()); 


itemintent.putExtra ("android.intent.extra.rssItem", b); 
startActivityForResult (itemintent, 0); 


9.4.3 Si ContentHandler 


ContentHandler 是 一 个 特殊 的 SAX 接口 ， 位 于 org.xml.sax.ContentHandler。 在 我 们 解 
析 XML 时 ， 大 多 数 步骤 都 是 固定 不 变 的 ， 但 是 关于 ContentHandler 的 实现 却 是 不 同 的 。 
实现 ContentHandler 是 解析 XML 中 最 重要 、 最 关键 的 步骤 之 一 。 下 面 将 讲解 其 具体 实现 
流程 。 

(1) 声明 RSSHandler 类 ， 声 明 继承 与 DefaultHandler 的 类 。DefaultHandler 类 是 一 个 基 
类 ， 此 类 里 面 最 简单 地 实现 了 一 个 ContentHandler， 只 需 在 其 中 重 写 里 面 的 重要 方法 即 
可 。 具 体 代码 如 下 : 


package com.rss reader.sax; 


import org.xml.sax.Attributes; 
import org.xml.sax.SAXException; 
import org.xml.sax.helpers.DefaultHandler; 


import android.util.Log; 


import com.rss reader.data.RSSFeed; 
import com.rss reader.data.RSSItem; 


public class RSSHandler extends DefaultHandler 
t 


RSSFeed rssFeed; 

RSSItem rssItem; 

String lastElementName = ""; 
final int RSS TITLE - 1; 
final int RSS LINK - 2; 

final int RSS DESCRIPTION - 3; 
final int RSS CATEGORY = 4; 
final int RSS PUBDATE = 5; 


int currentstate = 0; 
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public RSSHandler() 
t 
) 


public RSSFeed getFeed() 
{ 

return rssFeed; 
} 


(2) 分 别 重 写 startDocument() 和 endDocument()。 通 常 将 正式 解析 前 的 初始 化 工作 放 到 
startDocument() 中 ， 将 一 些 收尾 性 工作 放 到 endDocument0 中 。 具 体 代 码 如 下 : 


public void startDocument() throws SAXException 
t 


rssFeed new RSSFeed(); 
rssItem - new RSSItem(); 


) 
public void endDocument() throws SAXException 
{ 
} 


(3) E startElement, “4 XML 解析 器 遇 到 XML 文档 流 里 面 的 tag 时 ， 将 会 调用 此 函 
数 。 在 此 函数 内 部 通常 是 通过 参数 localName 进行 判断 并 进行 一 些 操作 处 理 的 。 具 体 代码 
如 下 : 


public void startElement (String namespaceURI, String 
localName,String qName, Attributes atts) throws SAXException 


t 
if (localName.equals ("channel")) 
t 
currentstate = 0; 
return; 


if (localName.equals ("item")) 


rssItem = new RSSItem(); 


return; 
} 
if (localName.equals ("title")) 
t 


currentstate — RSS TITLE; 
return; 


if (localName.equals ("description")) 


currentstate — RSS DESCRIPTION; 
return; 


if (localName.equals ("link")) 
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t 


currentstate — RSS LINK; 
return; 


) 
if (localName.equals ("category")) 


ü 
currentstate = RSS CATEGORY; 
return; 
} 
if (localName.equals ("pubDate") ) 
{ 
currentstate = RSS PUBDATE; 
return; 
) 


currentstate - 0; 
) 


(4) 重 写 endElement， 此 方法 和 startElement 方法 相对 应 ， 当 解析 tag 完毕 后 执行 此 方 
法 。 如 果 解 析 一 个 item 节点 结束 ， 就 将 RSSItem 添加 到 RSSFeed 中 去 。 上 有 具体 代码 如 下 : 


public void endElement (String namespaceURI, String localName, String 
qName) throws SAXException 


t 
// 如 果 解 析 一 个 item 节点 结束 ， 就 将 RSSItem 添加 到 RSSFeed 中 。 
if (localName.equals ("item")) 
t 
rssFeed.addItem(rssItem); 
return; 
) 
) 


(5) 重 写 characters， 此 方法 是 一 个 回调 方法 ， 当 解析 完 startElement 方法 后 ， 解 析 完 
点 内 容 后 会 执行 此 方法 ， 并 且 参 数 ch[] 就 是 节点 的 内 容 。 具 体 代 码 如 下 : 


UE 


public void characters(char ch[], int start, int length) 


{ 
String theString = new String (ch, start, length) ; 


switch (currentstate) 
{ 
case RSS TITLE: 
rssItem.setTitle (theString) ; 
currentstate = 0; 
break; 
case RSS LINK: 
rssItem.setLink (theString) ; 
currentstate = 0; 
break; 
case RSS DESCRIPTION: 
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rssItem.setDescription (theString); 
currentstate — 0; 
break; 

case RSS CATEGORY: 
rssItem.setCategory (theString); 
currentstate = 0; 
break; 

case RSS PUBDATE: 
rssItem.setPubDate (theString); 
currentstate - 0; 
break; 

default: 
return; 


9.4.4 主 程 序 文件 ActivityShowDescription java 


主 程序 文件 ActivityShowDescriptionjava 的 功能 是 ， 显 示 某 列表 信息 的 详细 信息 。 当 
单 击 列表 中 的 某 一 项 后 ， 会 进入 到 此 界面 。 如 果 程 序 出 错 ， 则 content 显示 出 错 提示 ; 运 
行 正确 则 在 content 中 分 别 显示 title, pubdate 和 description。 具 体 代码 如 下 : 


package com.rss reader; 


import android.app.Activity; 
import android.os.Bundle; 
import android.widget.Button; 
import android.widget.TextView; 
import android.content.Intent; 
import android.view.*; 


public class ActivityShowDescription extends Activity ( 
public void onCreate(Bundle icicle) ( 
super.onCreate (icicle); 
setContentView(R.layout.showdescription); 
String content - null; 
Intent startingIntent - getIntent(); 


if (startingIntent !- null) ( 
Bundle bundle = startingIntent 
-getBundleExtra ("android.intent.extra.rssItem"); 
if (bundle = null) { 
content = "不 好 意思 程序 出 错 啦 "; 
) eise ( 
content = bundle.getString("title") + "\n\n" 
+ bundle.getString ("pubdate") + "\n\n" 
+ bundle.getString ("description") .replace("\n', ' ') 
+ 


"\n\n 详细 信息 请 访问 以 下 网 址 : Nn". + 
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bundle.getString ("link"); 


} 
} else { 


content = "不 好 意思 程序 出 错 啦 "; 
) 


TextView textView = (TextView) findViewById(R.id.content) ; 
textView.setText (content); 


Button backbutton = (Button) findViewById(R.id.back) ; 


backbutton.setOnClickListener(new Button.OnClickListener() ( 
public void onClick(View v) ( 
finish(); 
) 
n; 


9.45 ” 主 布 局 文件 main.xml 


主 布局 文件 main.xml 用 于 定义 系统 初始 主 界面 ， 即 列表 显示 获取 的 RSS 信息 。 具 体 
代码 如 下 : 
«?xml version-"1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:orientation-"vertical" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
> 
<ListView 
android:layout width="fill parent" 
android:layout height="fill parent" 
android: id="@+id/itemlist" 


/> 
</LinearLayout> 


9.4.6 详情 布局 文件 showdescription.xml 


当 用 户 单 击 列表 信息 后 ， 会 进入 信息 详情 界面 ， 此 界面 是 由 布局 文件 
showdescription.xml 定义 的 。 具 体 代码 如 下 : 


<?xml version-"1.0" encoding-"utf-8"?» 

<LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:orientation-"vertical" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
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<TextView 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:autoLink-"all" 
android:text-"" 
android:id-"G«id/content" 
android:layout weight-"1.0" 
/> 

<Button 
android:layout width="fill parent" 
android:layout height="wrap content" 
android:text=" 返 回 " 
android: id="@+id/back" 
/> 


</LinearLayout> 
至 此 ， 整 个 实例 介绍 完毕 。 运 行 后 将 获取 指定 RSS 中 的 信息 ， 如 图 9-7 所 示 。 单 击 某 
条 信息 后 会 显示 此 信息 的 相关 描述 性 信息 ， 如 图 9-8 所 示 。 


网 易 博 客 阅读 器 


图 9-7 执行 效果 图 9-8 ”相关 描述 性 信息 
单 击 图 9-8 中 间 的 链接 后 ， 能 够 显示 此 条 RSS 的 详细 信息 ， 如 图 9-9 所 示 。 


mer 
memmmmmmmm 
Annee 
一 一 一 一 一 一 一 一 一 一 


mu 


图 9-9 详细 信息 
本 实例 默认 显示 的 是 博客 http://woshiyigebing12345.blog.163.com/ 中 的 信息 。 读 者 也 可 
以 指定 显示 其 他 RSS 信息 ， 在 使 用 时 可 以 登录 http://www.feedsky.com/ 来 设置 不 同 的 RSS 
订阅 。 具 体 设置 流程 如 下 。 


Andieid sas niei 
(1) 登录 http://www.feedsky.com/ 主 界面 ， 如 图 9-10 所 示 。 


FeedSky** BARN MFeedBe, RiT. WH HRE 
donas 


PE me ee pean sato Fe 


请 输入 你 的 博客 (Blog) 或 Feed 地 址 


eno Sean 
anta 
RIMM MADE BATRA SPER 广告 收入 
nF RMR -SINA HB 
RATER” AiD, FUTURIS SEN M 
sins. GT-R 有 并 
PBN. WS RE, reme 
asear 


9-10 feedsky.comz RM 


(2) 在 图 9-10 顶部 的 文本 框 中 输入 要 显示 信息 的 博客 地 址 、Feed 地 址 或 QQ 号 码 ， 然 
后 单 击 “ 下 一 步 ”按钮 ， 如 图 9-11 所 示 。 


FeedSKy*# 强大 完善 的 Feed 添 加 、 发 行 、 管 理 、 统 计 服 务 
www.feedsiy com. PecckANRA ARRAI 


请 输入 你 的 博客 (Blogl1 或 Feed 地 址 


图 9-11 输入 设置 的 博客 、QQ 或 Feed 地 址 


(3) 在 弹出 的 如 图 9-12 所 示 的 界面 中 分 别 输入 “名 称 ”、“ 描 述 ” 和 tag， 并 设 定 永 
久 性 Feed 地 址 。 


添加 Feed feed$ Ey" 


第 二 步 : 设置 Feed 相 关 信息 


reaz: [$8 


GMA MPA SOME RK bogs, AISEE 
设 定 永久 Feed 地 址 : htp teed feedsky com{ weshiyigebin2 


请 设 定 你 的 永久 Fesd 地 址 ,此 地 址 一 忠 注 邮 不 能 修改， 即 失 你 的 博客 (Blog ) 
BET ， 订 阅读 者 也 不 会 丢失 。 


GuEHBFeedskRiD . 如 里 你 已 经 注册 Relig 


E-mail 
EE n 
ar = 
LOC 
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图 9-12 中 的 永久 Feed 地 址 就 是 RSS 的 源 地 址 ， 这 样 就 可 以 将 此 地 址 添加 到 实例 中 ， 
从 而 显示 此 地 址 的 RSS 资源 信息 ， 也 就 是 显示 博客 http://woshiyigebing12345.blog.163.com/ 
中 的 信息 。 


:第 10 章 
在 Andgroid 中 开发 电子 邮件 应 用 


自从 互联 网 诞生 以 来 ， 电 子 邮件 就 成 为 吸引 用 户 应 用 网 络 
的 主要 原因 之 一 。 无 论 是 亲朋 好 友之 间 的 祝福 和 交流 ， 还 是 商 
务 中 的 信息 往来 ， 都 离 不 开 电 子 邮 件 。 自 从 进入 信息 时 代 之 
É, E-mail 就 成 为 网 络 中 的 弄潮儿 ， 深 受 人 们 的 青睐 。 本 章 将 
详细 介绍 在 Android 平台 中 开发 电子 邮件 应 用 的 基本 知识 ， 为 
读者 步 入 本 书后 面 知 识 的 学 习 打 下 基础 。 
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10.4 使 用 Android 的 内 置 邮 件 系统 


其 实 无 须 开 发 人 员 伤 脑筋 ， 在 Android 系统 中 Google 内 置 了 功能 强大 的 Gmail 邮件 系 
统 。 我 们 只 需 对 其 进行 相关 设置 ， 就 可 以 使 用 内 置 的 邮件 系统 收发 邮件 。 


10.1.1 Android 邮件 客户 端 配置 
在 Android 操作 系统 中 除了 有 Gmail 外 ， 还 包含 了 一 个 功能 强大 的 E-mail 电子 邮件 客 
户 端 ， 支 持 POP3 和 IMAP 协议 。 在 设置 Android 邮件 客户 端 之 前 需要 确保 手机 已 连通 无 


线 或 有 线 网 络 。 
(1) 进入 Android 操作 系统 的 应 用 程序 界面 ， 找 到 E-mail 图 标 ， 如 图 10-1 所 示 。 
Q) 首次 进入 需要 设置 一 个 电子 邮箱 账户 及 密码 ， 输 入 我 们 的 免费 邮箱 账号 和 密码 ， 


例如 21CN 的 邮箱 ， 然 后 单 击 “ 下 一 步 ” 按 钮 ， 如 图 10-2 所 示 。 


您 只 需 执行 几 个 步骤 ， 即 可 为 大 多 数 
帐户 配置 电子 邮件 ， 


Qwertyujop 


asdfghjkl 


图 10-1 找到 E-mail 图 标 10-2 ”输入 邮箱 信息 


G) 在 “添加 新 电子 邮件 帐户 ”界面 中 选择 账户 类 型 ，21CN 免费 邮箱 支持 POP3 及 
IMAP 服务 器 接收 ， 在 此 根据 需要 选择 POP3 或 是 IMAP 方式 接收 邮件 ， 如 图 10-3 所 示 。 

(4) 如 果 账 户 类 型 选择 的 是 POP3， 则 在 此 输入 用 户 名 (完整 的 邮件 地 址 )、 密 码 、21CN 
免费 邮箱 的 POP3 服务 器 名 称 “pop.21cn.com” 及 端口 “110”， 如 图 10-4 所 示 。 

(5) 因为 21CN 免费 邮箱 支持 POP 的 SSL 加 密 连 接 方式 ， 若 需 使 用 SSL 加 密 连 接 ， 单 
击 “ 安 全 类 型 ”的 下 拉 按 钮 ， 选 择 SSL， 设 置 POP 方式 的 接收 邮件 服务 器 “pop.21cn.com”， 
安全 类 型 为 SSL， 端 口号 为 995， 如 图 10-5 所 示 。 

(6) 如 果 账 户 类 型 选择 的 是 IMAP， 则 输入 用 户 名 (完整 的 邮件 地 址 )、 密 码 、21CN 免 
费 邮 箱 的 IMAP 服务 器 名 称 “imap.21cn.com” 及 端口 “143”， 如 图 10-6 所 示 。 


图 10-3 账户 类 型 
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T 
test 21cn.com 
ES 


cd 


pops pam 


Pop.21cn.com 


ARX Rd TG 
一 律 不 


图 10-4 ”接收 服务 器 设置 


test@21cn.com 
12) 


Rm 


图 10-5 


(7) 同样 因为 21CN 免费 邮箱 支持 IMAP 的 SSL 加 密 连 接 方式 ， 若 需 使 用 SSL 加 密 连 
接 ， 单 击 “ 安 全 类 型 ”下 拉 按 钮 ， 选 择 SSL, Be IMAP 方式 的 接收 邮件 服务 器 


设置 SSL 加 密 连 接 方式 


“imap.21cn.com”， 安 全 类 型 为 SSL， 端 口号 为 993， 如 图 10-7 所 示 。 


(8) 配置 好 接收 服务 器 后 单 击 “ 下 一 步 ” 按 钮 ， 此 时 手机 将 与 服务 器 相连 以 检查 接收 


服务 器 的 设置 ， 如 图 10-8 所 示 。 


(9) 如 果 检 查 接收 服务 器 的 设置 正确 ， 则 进入 “外 发 服务 器 设置 ”界面 ， 在 此 输入 
21CN 免费 邮箱 的 SMTP 服务 器 “smtp.21cn.com”、 
和 密码 ， 同 时 必须 开启 “需要 登录 ”， 


端口 “25”、 用 户 名 (完整 的 邮件 地 址 ) 


设置 完成 后 单刀 


“下 一 步 ” 按 钮 ， 如 图 10-9 所 示 。 
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APS 


test@21cn.com 


SSL ( 接受 所 有 证 书 ) 
TLS 


TLS ( ESERTESUESS ) 


图 10-7 设置 SSL 加 密 连接 


SMTP 服务 路 


正在 检查 接收 服务 器 设置 


图 10-8 检查 设置 图 10-9 外 发 服务 器 设置 

(10) 进入 “帐户 选项 ”设置 界面 ， 单 击 “ 收 件 箱 检查 频率 ”下 拉 按 钮 可 以 进行 收 件 箱 
频率 的 设置 ， 选 择 “ 一 律 不 ”选项 对 于 CMNET 的 GPRS 用 户 比较 合适 ， 如 果 使 用 Wi-Fi 
可 以 选择 “每 隔 5 分 钟 ”、“ 每 隔 10 分 钟 ”等 选项 ， 最 后 单 击 “ 下 一 步 ” 按 钮 ， 如 图 10-10 
所 示 。 

(11) 设置 邮箱 的 昵称 ， 即 发 件 人 姓名 等 属性 ， 比 如 输入 “Kelly”， 最 后 单 击 “ 完 成 ” 
按钮 完成 设置 ， 如 图 10-11 所 示 。 

此 时 就 会 在 “ 收 件 箱 ” 中 看 到 电子 邮件 了 。 
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一 律 不 


默认 情况 下 从 此 帐户 发 送 电 子 邮 件 . SHS sot 


O 收 到 电子 部 件 时 通知 我 。 
SR 10958 


SA 15 分 钟 


19/8 30 分 钟 


每 小 时 


图 10-10 “ 收 件 箱 检查 频率 设置 ”界面 


设置 电子 邮件 
vip , 可 以 使 用 电子 邮件 
1 


[ott glue pr ( 可 选 


图 10-11 设置 电子 邮件 


10.1.2 ”调用 内 置 邮件 系统 在 发 送 短 信 时 实现 E-mail 通知 


在 Android 系统 中 ， 可 以 用 编程 的 方式 调用 内 置 邮件 系统 来 发 送 邮件 。 在 具体 实现 
时 ， 需 要 用 Intent 来 配合 实现 。 为 了 说 明 具 体 原理 ， 我 们 先 看 下 面 的 一 段 代码 。 


Intent intent = new Intent (android.content.Intent.ACTION SEND); 
intent.putExtra (android.content.Intent.EXTRA EMAIL, new 
String[]{"test@test.com"}) ; 

intent .putExtra(android.content.Intent.EXTRA SUBJECT, "SUBJECT"); 
intent .putExtra(android.content.Intent.EXTRA TEXT, "TEXT"); 
intent .setType ("text/html"); 
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startActivity (Intent.createChooser (intent, "Chooser")); 

Intent intent = new Intent (android.content.Intent.ACTION SEND); 

在 上 述 代 码 中 ， 将 所 有 含有 发 送 功能 的 APP 做 成 一 个 列表 以 供 选择 ， 然 后 用 putExtra() 
方法 将 邮件 的 各 个 部 分 发 送 E-mail 程序 。 方 法 putExtra0 的 语法 格式 如 下 : 

intent .putExtra (android.content.Intent.EXTRA STREAM,URL url); 


第 一 个 参数 EXTRA STREAM 表示 传输 的 数据 ， 具 体 说 明 如 下 。 

Q EXTRA EMAIL: 发 送 的 是 收 件 人 地 址 。 

Q EXTRA SUBJECT: 邮件 标题 。 

Q EXTRA TEXT: 邮件 文本 内 容 。 

口 EXTRA STREAM: 邮件 附件 。 

第 二 个 参数 url 表示 传递 对 象 的 URL 地 址 。 

下 面 将 通过 一 个 具体 实例 来 讲解 在 发 送 短信 时 实现 E-mail 邮件 通知 的 过 程 。 


源码 路 径 


在 收 到 短信 时 实现 Email 邮件 通知 


在 本 实例 中 ， 当 用 户 收 到 一 条 短信 后 ， 先 用 Toast 提示 获取 了 短信 ， 然 后 使 用 E-mail 
发 送 提示 到 用 户 的 邮箱 中 ， 这 样 就 可 以 将 重要 的 短信 放 在 邮箱 中 保存 ， 从 而 不 用 担心 短信 
容量 的 问题 了 。 

在 具体 实现 上 ， 先 在 后 台 设 计 一 个 BroadcastReseiver 用 于 等 待 接收 短信 。 当 接收 到 短 
信 后 ， 使 用 Bundle 方式 封装 短信 内 容 ， 然 后 通过 Intent 方式 返回 给 主 程序 Activity。 因 为 
Receiver 无 法 直接 发 送 E-mail， 所 以 需要 将 控制 权 返回 给 主 程序 ， 通 过 主 程序 来 运行 发 送 
E-mail 的 工作 。 当 主 程序 收 到 Bundle 后 ， 会 以 Bundle.getString 的 方法 来 取得 返回 短信 的 
内 容 ， 然 后 以 _Intent.setType("plain/text") 来 设置 要 打开 的 Intent 类 型 ， 并 以 关键 程序 
Intent.putExtra(android.content.Intent.EXTRA EMAIL.strEmailReciver) 来 指定 要 打开 的 是 
E-mail 所 需要 的 Extra 参数 ， 当 Android 系统 收 到 这 些 参 数 后 ， 就 会 打开 内 置 的 E-mail 发 
送 程序 。 读 者 在 此 需要 注意 的 是 ， 在 模拟 器 运行 后 会 显示 “No application can perform this 
action” 的 提示 ， 而 在 真实 机 器 上 不 会 出 现 此 问题 。 

本 实例 的 具体 实现 流程 如 下 。 

(1) 编写 文件 tongjava， 其 具体 实现 流程 如 下 。 

© 分 别 声明 一 个 TextView、String 数组 和 两 个 文本 字符 串 变量 ， 主 要 代码 如 下 : 

/* 声 明 一 个 TextView、String 数组 与 两 个 文本 字符 串 变量 */ 
private TextView mTextViewl; 

public String[] strEmailReciver; 

public String strEmailSubject; 

public String strEmailBody; 

© 通过 findViewById 构造 器 来 创建 TextView 对 象 ， 并 通过 TextView 来 显示 “等 待 
中 ...” 的 提示 。 主 要 代码 如 下 : 


public void onCreate (Bundle savedInstanceState) 
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super.onCreate (savedInstanceState); 

setContentView (R.layout.main); 

/* 通 过 £indviewByrd 构造 器 创建 Textview 对 象 */ 

mTextViewl = (TextView) findViewById(R.id.myTextViewl); 
mTextViewl.setText ("等 待 中 ..."); 


图 通过 try 语句 获取 短信 传 来 的 bundle 堆 信 息 ， 并 取出 bunde 中 的 字符 串 ， 然 后 自 定 
X Intent 来 寄 送 E-mail 邮件 信息 ， 同 时 设置 邮件 格式 为 “plain/text”， 并 分 别 取 得 
EditText01、EditText02、EditText03 和 EditText04 的 值 作为 收 件 人 的 地 址 、 附 件 、 主 题 和 
正文 ， 最 后 将 取得 的 字符 串 放 入 mEmailIntent 中 。 主 要 代码 如 下 : 


try ( 
/* 取 得 短信 传 来 的 bundle 堆 信息 */ 
Bundle bunde = this.getIntent().getExtras(); 
if (bunde!- null) 
t 
/* 将 bunde 内 的 字符 串 取出 */ 
String sb = bunde.getString("STR INPUT"); 
/* 自 定义 一 个 Intent 来 运行 寄 送 E-mail 的 工作 */ 
Intent mEmailIntent = 
new Intent (android.content.Intent.ACTION SEND); 
/* 设 置 邮件 格式 为 "plain/text"*/ 
mEmailIntent.setType ("plain/text"); 


/* 取 得 EditText01、EditText02、EditText03、EditText04 的 值 作为 收 件 人 的 
地 址 、 附 件 、 主 题 、 正 文 */ 

strEmailReciver -new String[] {"jay-mingchieh@gmail.com"}; 

strEmailSubject = "你 有 一 封 短信 !!"; 

strEmailBody = sb.toString(); 


/* 将 取得 的 字符 串 放 入 mEmailIntent 中 */ 
mEmailIntent.putExtra (android.content.Intent.EXTRA EMAIL, 
strEmailReciver); 
mEmaillIntent.putExtra (android.content.Intent.EXTRA SUBJECT, 
strEmailSubject); 
mEmailIntent.putExtra (android.content.Intent.EXTRA TEXT, 
strEmailBody); 
startActivity(Intent.createChooser (mEmailIntent, 
getResources() .getString(R.string.str message))); 
} 
else 
{ 
finish (); 
} 
} 
catch (Exception e) 


{ 
e.printStackTrace(); 
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(2) 编写 文件 SMSreceiverjava， 其 具体 实现 流程 如 下 。 
(D 引用 BroadcastReceiver 类 ， 使 用 telephoney.gsm.SmsMessage 来 接收 短信 ， 使 用 
Toast 类 来 通知 用 户 收 到 短信 ， 主 要 代码 如 下 : 


/* 使 用 telephoney .gsm.SmsMessage 来 收取 短信 */ 
import android.telephony.gsm.SmsMessage; 
/* 使 用 Toast 类 来 告知 用 户 收 到 短信 */ 

import android.widget.Toast; 


© 自 定义 继承 自 BroadcastReceiver 类 ， 用 于 侦 听 系统 服务 广播 的 信息 ， 然 后 声明 静 
态 字符 串 并 作为 Action 启动 短信 的 依据 ， 主 要 代码 如 下 : 
public class SMSreceiver extends BroadcastReceiver 


{ 
* android.provider.Telephony.SMS RECEIVED 
private static final String mACTION = 
"android.provider.Telephony.SMS RECEIVED"; 


private String str receive=" 收 到 短信 !"; 

@ 定义 方法 onReceive(Context context, Intent intent) 来 获取 短信 ， 先 通过 站 语句 判断 
传 来 的 Intent 是 否 为 短信 ， 如 果 为 短信 和 则 建构 一 字符 串 集合 变量 sb 并 接收 由 Intent 传 来 的 
数据 。 主 要 代码 如 下 : 

public void onReceive(Context context, Intent intent) 


t 
Toast.makeText (context, str receive.toString(), 
Toast.LENGTH LONG).show(); 
/* 判 断 传 来 的 Intent 是 否 为 短信 */ 
if (intent.getAction() .equals (mACTION)) 
t 
/* 建 构 一 字符 申 集合 变量 sb*/ 
StringBuilder sb = new StringBuilder(); 
/* 接 收 由 Intent 传 来 的 数据 */ 
Bundle bundle = intent.getExtras(); 


@ 使 用 if 语句 判断 在 Intent 中 是 否 有 数据 ， 用 pdus 作为 Android 内 置 短信 参数 
identifier， 并 通过 bundle.get("") 返 回 一 包含 pdus 的 对 象 。 主 要 代码 如 下 : 
/* 判 断 Intent 是 有 数据 */ 


if (bundle != null) 


{ 
Object[] myOBJpdus = (Object[]) bundle.get ("pdus") ; 


© 构造 短信 对 象 aray， 然 后 依据 收 到 的 对 象 长 度 来 创建 array 的 大 小 。 主 要 代码 如 下 : 
SmsMessage[] messages = new SmsMessage [myOBJpdus. length]; 


for (int i = 0; i<myOBJpdus.length; i++) 


{ 
messages[i] = SmsMessage.createFromPdu((byte[]) myOBJpdus[i]); 
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© 分 别 获取 收 信人 的 电话 号 码 ， 并 将 传 来 的 信息 保存 在 BODY。 主 要 代码 如 下 : 


for (SmsMessage currentMessage : messages) 

{ 
Sb.append ("接收 到 来 自 : Nn") ; 
/* 收 信 人 的 电话 号 码 */ 
Sb.append (currentMessage.getDisplayOriginatingAddress ()); 
Sb.append ("\n------ 传 来 的 短信 ------ in"); 
/* 取得 传 来 信息 的 BODY */ 
Sb.append (currentMessage.getDisplayMessageBody () ) ; 
Toast.makeText 
( 

context, sb.toString(), Toast.LENGTH LONG 

) .show() > 

} 

} 


C) 使 用 Notification(Toase) 提 醒 来 显示 提示 信息 ， 主 要 代码 如 下 : 


Toast.makeText 
( 

context, sb.toString(), Toast. LENGTH LONG 
) .show(); 


@ 返回 主 Activity， 然 后 自 定义 一 个 Bundle， 将 短信 信息 以 putString() 方 法 存 入 自 定 
义 的 bundle 内 ， 最 后 设置 Intent 的 Flag 以 一 个 全 新 的 task 来 运行 。 主 要 代码 如 下 : 


Intent i = new Intent(context, GMail.class); 

/* 自 定义 一 个 Bundle*/ 

Bundle mbundle = new Bundle(); 

/* 将 短信 信息 以 putString () 方 法 存 入 自 定义 的 bundle 内 */ 
mbundle.putString("STR INPUT", sb.toString()); 
/*#§ EISE X bundle 5A Intent 中 */ 

i.putExtras (mbundle); 

/* Wt Intent 的 Flag 以 一 个 全 新 的 task 来 运行 */ 
i.addFlags (Intent. FLAG ACTIVITY NEW TASK); 
context.startActivity (i); 


} 


(3) 编写 文件 AndroidManifest.xml， 向 系统 注册 一 个 常 驻 的 BroadcastReseiver， 并 设置 
这 个 Reseiver 的 intent-filter， 让 其 SMSreceiver 针对 收 到 短信 事件 做 出 反应 ， 并 声明 
android.permission. RECEIVE SMS 权限 。 主 要 代码 如 下 : 


<intent-filter> 
«action android:name-"android.intent.action.MAIN" /> 
«category android:name-"android.intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 
<!-- 建立 receiver 来 侦 听 系统 广播 信息 --> 


«receiver android:name="irdc.tong.SMSreceiver"> 
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<!-- 设置 要 捕捉 的 信息 名 是 provider 中 的 Telephony.SMS RECEIVED --> 
«intent-filter» 
«action 
android:name-"android.provider.Telephony.SMS RECEIVED" /» 
«/intent-filter» 
«/receiver» 
«/application» 
«uses-permission android:name-"android.permission.RECEIVE SMS"> 
«/uses-permission» 
«/manifest» 


实例 执行 后 ， 如 果 收 到 一 条 短信 和 则 会 显示 提示 信息 ， 并 自动 生成 一 条 邮件 提示 ， 如 
图 10-12 所 示 。 


图 10-12 运行 效果 
10.1.3 ”调用 内 置 邮件 系统 在 来 电 时 实现 自动 邮件 通知 


在 实例 10-1 中 ， 介 绍 了 来 短信 后 自动 发 送 邮件 通知 的 实现 过 程 。 同 理 也 可 以 编写 一 个 
程序 ， 在 来 电 时 实现 自动 邮件 通知 功能 。 


源码 路 径 


在 来 电 时 实现 E-mail 邮件 通知 下 载 路 径 \daima\10\dian 


在 本 实例 中 ， 通 过 TelephoneManage 来 判断 来 电 状态 ， 并 实现 来 电 通 知 。 程 序 通过 E-mail 
来 通知 来 电 记 录 ， 本 实例 继承 了 前 面 的 实例 ， 并 再 次 对 PhoneCallListener 来 判断 电话 事 
件 ， 并 根据 来 电 状态 发 送 E-mail。 

本 实例 的 具体 实现 流程 如 下 。 

(1) 编写 文件 strings.xml， 设 置 在 屏幕 中 显示 的 文本 ， 具 体 代码 如 下 : 


«?xml version-"1.0" encoding="utf-8"?> 

«resources» 
«string name="hello"></string> 
«string name-"app name"></string> 
«string name="str_buttonl1"> 获 取信 息 </string> 
«string name-"str CALL STATE IDLE"> 待 机 状态 中 </string> 
«string name-"str CALL STATE OFFHOOK"> 通 话 中 ...</string> 
«string name-"str CALL STATE RINGING"> 有 电话 .. .</string> 


«string name-"str EmailBody"> 有 电话 . . - .</string> 
«string name="str message"> 发 信 中 . . . .</string> 
</resources> 


(2) 编写 文件 dianjava， 具 体 实现 流程 如 下 。 
(D 定义 TelephonyManager 对 象 telMgr， 通 过 此 对 象 获取 TELEPHONY SERVICE 系 
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统 信息 ， 主 要 代码 如 下 : 


public void onCreate (Bundle savedInstanceState) 
t 
super.onCreate (savedInstanceState); 
setContentView (R.layout.main); 


mPhoneCallListener phoneListener=new mPhoneCallListener(); 

/* 对 象 telMgr， 用 于 获取 TELEPHONY SERVICE 系统 */ 

TelephonyManager telMgr = (TelephonyManager) getSystemService 
(TELEPHONY SERVICE) ; 

telMgr.listen(phoneListener, mPhoneCallListener. 
LISTEN CALL STATE) ; 

mTextViewl = (TextView) findViewById(R.id.myTextViewl) ; 


© 


使 用 PhoneCallListener 来 侦 听 电话 状态 更 改 事件 ， 方 法 onCallStateChanged 的 功能 


分 别 获 取 电 话 待机 状态 、 通 话 状 态 和 来 电 状态 。 
显示 号 人 码 。 
有 电话 时 发 送 邮 件 。 
设置 收 信人 邮箱 地 址 。 
设置 邮件 标题 。 
设置 邮件 内 容 。 
实现 发 信 处 理 。 
上 述 功 能 的 主要 代码 如 下 : 
public class mPhoneCallListener extends PhonestateListener 
{ 
GOverride 
public void onCallStateChanged(int state, String incomingNumber) 
t 
switch (state) 
{ 
/* 获取 电话 待机 状态 */ 
case TelephonyManager.CALL STATE IDLE: 
mTextViewl.setText(R.string.str CALL STATE IDLE); 
break; 
/* 获取 电话 通话 状态 */ 
case TelephonyManager.CALL STATE OFFHOOK: 
mTextViewl.setText(R.string.str CALL STATE OFFHOOK); 
break; 
/* 获取 电话 来 电 状态 */ 
case TelephonyManager.CALL STATE RINGING : 
mTextViewl.setText 
( 
/* 显 示 号 码 */ 
getResources().getText(R.string.str CALL STATE RINGING)+ 
incomingNumber 


DODDODUDGU 
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/有 电话 时 发 送 邮 件 xy 

Intent mEmaillntent = new Intent (android.content.Intent 
-ACTION SEND); 

mEmailIntent.setType ("plain/text"); 

/* 设 置 收 信人 邮箱 地 址 */ 

mEmaillIntent.putExtra (android.content.Intent.EXTRA EMAIL, 
new String[](mEditTextOl.toString()]); 

/* 设 置 邮件 标题 */ 

mEmailIntent.putExtra (android.content.Intent.EXTRA SUBJECT, 
strEmailSubject); 

/* 设 置 邮件 内 容 */ 

mEmailIntent.putExtra (android.content.Intent .EXTRA TEXT, 
R.string.str EmailBody+incomingNumber) ; 

/* 实 现 发 信 处 理 */ 

startActivity (Intent.createChooser (mEmailIntent, 
getResources().getString(R.string.str message))); 

break; 

default: 
break; 
} 
super.onCallStateChanged(state, incomingNumber) ; 
} 
} 
} 


执行 后 当 有 电话 进来 时 会 显示 提示 信息 ， 有 短信 时 也 会 显示 对 应 的 提示 ， 如 图 10-13 
所 示 。 


图 10-13 来 电 时 的 界面 


10.14 ”调用 内 置 邮件 系统 实现 邮件 发 送 


在 使 用 Intent 调用 内 置 邮 件 系 统 时 ， 使 用 的 行为 是 android.content.Intent. 
ACTION_SEND。 实 际 上 在 Android 系统 中 使 用 的 邮件 发 送 服务 是 调用 Gmail 程序 ， 而 并 
不 是 直接 使 用 SMTP 的 Protocol。 


实例 | 功 能 源码 路 径 
实例 10-3 | 简易 E-mail 邮件 发 送 系 统 TF 3,545 aima 0 sendEmail 


本 实例 的 具体 实现 流程 如 下 。 
(1) 编写 布局 文件 main xml， 具 体 代 码 如 下 : 
<?xml version-"1.0" encoding-"utf-8"?» 


<AbsoluteLayout 
android: id="@+id/widget34" 
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android:layout width-"fill parent" 

android:layout height-"fill parent" 

android: background="@drawable/white" 

xmlns:android-"http://schemas.android.com/apk/res/android" 

> 

<TextView 
android: id="@+id/myTextViewl" 
android: layout width-"wrap content" 
android:layout height="wrap content" 
android:text="@string/str_receive" 
android:layout x="60px" 
android:layout y="22px" 

> 

</TextView> 

<TextView 
android:id="@+id/myTextView2" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text-"Gstring/str cc" 
android:layout x-"60px" 
android:layout y-"82px" 

2 

«/TextView» 

<EditText 
android: id="@+id/myEditText1" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:textSize-"18sp" 
android:layout x-"120px" 
android:layout y="12px" 


> 

</EditText> 

<EditText 
android: id="@+id/myEditText2" 
android: layout_width="fill_ parent" 
android: layout height-"wrap content" 
android: textSize="18sp" 
android:layout x="120px" 
android:layout y="72px" 

> 

</EditText> 

<Button 


android: id="@+id/myButton1" 
android:layout width="wrap content" 
android: layout height="124px" 
android:text="@string/str button" 
android:layout x-"Opx" 
android:layout y-"2px" 
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«/Button» 

«TextView 
android: id="@+id/myTextView3" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:text="@string/str subject" 


android:layout x="60px" 
android: layout y="142px" 

> 

</TextView> 

<EditText 
android: id="@+id/myEditText3" 
android:layout width="fill parent” 
android:layout height="wrap content" 
android: textSize="18sp" 
android:layout x="120px" 
android:layout y="132px" 


</EditText> 

<EditText 
android: id="@+id/myEditText4" 
android:layout width="fill parent" 
android:layout height="209px" 
android: textSize="18sp" 
android:layout x-"Opx" 
android:layout y-"202px" 

2 

</EditText> 

</AbsoluteLayout> 


(2) 编写 主 程序 文件 sendEmailActivity.java， 其 具体 实现 流程 如 下 。 
© 定义 方法 boolean isEmail0 用 于 判断 用 户 输入 的 邮箱 是 否 正确 ， 具 体 代 码 如 下 : 
public static boolean isEmail(String strEmail) ( 


String strPattern = "^[a-zA-Z] [NNWWNN.-]* [a-zA-Z0-9] € [a-zA-Z0-9] 
[\\w\\ .-]* [a-ZA-Z0-9] NV. [a-zA-Z] [a-zA-Z\\.]* [a-zA-Z] $"; 


Pattern p Pattern.compile (strPattern); 

Matcher m = p.matcher(strEmail); 

return m.matches(); 

H 
© 当 用 户 长 按 文本 框 后 ， 需 通过 Content Provider 查找 跳 转 到 联系 人 中 心 ， 查 找 用 户 

并 返回 邮箱 ， 代 码 如 下 : 
private OnLongClickListener searhEmail-new OnLongClickListener () { 
public boolean onLongClick(View arg0) ( 
Uri uri-Uri.parse("content://contacts/people"); 


Intent intent-new Intent(Intent.ACTION PICK,uri); 
startActivityForResult(intent, PICK CONTACT SUBACTIVITY); 


0B 第 10 章 ft Android 中 开发 电子 邮件 应 


return false; 
} 


protected void onActivityResult (int requestCode, int resultCode, 
Intent data) ( 


switch (requestCode) ( 
case PICK CONTACT SUBACTIVITY: 
final Uri uriRet-data.getData(); 
if (uriRet!-null) 
t 
try { 
Cursor c=managedQuery(uriRet, null, null, null, null); 
c.moveToFirst (); 
// 取 得 联系 人 的 姓名 
String strName-c.getString(c.getColumnIndexOrThrow 
(People.NAME)); 
// 取 得 联系 人 的 E-mail 
String[] PROJECTION-new String[]{ 
Contacts.ContactMethods. ID, 
Contacts.ContactMethods.KIND, 
Contacts.ContactMethods.DATA 
Hn 
// 查 询 指定 人 的 E-mail 
Cursor newcur-managedQuery ( 
Contacts.ContactMethods.CONTENT URI, 
PROJECTION, 
Contacts.ContactMethods.PERSON ID+"=\'" 
*c.getLong(c.getColumnIndex(People. ID))+"\'", 
null, null); 
startManagingCursor (newcur); 
String email-""; 
if (newcur.moveToFirst () 
t 
email-newcur.getString (newcur.getColumnIndex 
(Contacts.ContactMethods.DATA)); 
myEditText.setText (email); 


) catch (Exception e) ( 
// TODO: handle exception 
Toast.makeText (sendEmailActivity.this, e.toString(), 
1000).show(); 


b 
break; 


default: 
break; 
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} 


super .onActivityResult (requestCode, resultCode, data); 
» 


要 想 实现 跳 转 并 取 值 返回 ， 需 要 用 到 startActivityForResult(intentrequestCode), $} 
requestCode 表示 一 个 Activity 要 返回 值 的 依据 ， 可 以 是 任意 的 int 类 型 。 我 们 可 以 自己 定 
义 常量 ， 也 可 以 自己 指定 数字 。 在 程序 中 覆盖 了 onActivityResult() 方 法 ， 当 程序 收 到 result 
后 ， 再 重新 加 载 写 回 原本 需要 加 载 的 控件 上 。 在 本 例 中 调用 了 文本 框 的 长 按 事件 ， 当 文本 
框 长 按 即 自行 跳 转 到 联系 人 页 面 上 ， 点 击 需 要 的 联系 人 名 称 ， 返 回 该 联系 人 的 邮箱 号 回 到 
主 程序 窗口 并 加 载 到 文本 上 。 

Q 单 击 “ 发 送 ”按钮 后 触发 事件 开始 发 送 。 邮 件 发 送 程序 并 不 复杂 ， 主 要 是 在 
EditText 、Button 控件 的 构建 ， 通 过 构造 一 个 自 定 义 的 Intent(android.content Intent. 
ACTION_SEND) 作 为 传送 E-mail 的 Activity 之 用 。 在 该 mtent 中 ， 还 必须 使 用 setType() 
来 决定 E-mail 的 格式 ， 使 用 putExtra() 来 置 入 寄 件 人 (EXTRA_EMAIL)、 主 题 (EXTRA_ 
SUBJECT). 、 邮 件 内 容 (EXTRA TEXT) 以 及 其 他 E-mail 的 字段 (EXTRA BCC 、 
EXTRA_CC)。 对 应 的 代码 如 下 : 


myButton.setOnClickListener(new OnClickListener() ( 
Goverride 
public void onClick(View v) ( 
// TODO Auto-generated method stub 
Intent mailIntent-new Intent (android.content.Intent.ACTION SEND); 
mailIntent.setType ("plain/test"); 
strEmailReciver-new String[]{ myEditText.getText().toString() }; 
strEmailCC-new String[] {myEditText2.getText () .toString() }; 
strEmailSubject=myEditText3.getText () .toString(); 
strEmailBody-myEditText4.getText () .toString(); 
mailIntent.putExtra (android.content.Intent.EXTRA EMAIL, 
strEmailReciver) ; 
mailIntent.putExtra (android.content.Intent.EXTRA CC, strEmailCc) ; 
mailIntent.putExtra (android.content.Intent.EXTRA SUBJECT, 
strEmailSubject); 
maillIntent.putExtra (android.content.Intent.EXTRA TEXT, 
strEmailBody); 
startActivity(Intent.createChooser (mailIntent, getResources(). 
getString(R.string.send))); 
) 
he 


(3) 在 文件 AndroidManifestxml 中 声明 权限 ， 即 当 使 用 Content Provider 查找 联系 人 时 
必须 在 此 配置 文件 中 声明 如 下 权限 : 
«uses-permission android:name-"android.permission.READ CONTACTS"/» 


执行 后 的 效果 如 图 10-14 所 示 。 
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图 10-14 ”执行 效果 


10.1.5 ”调用 内 置 Gmail 发 送 邮 件 


在 本 实例 中 自 定义 了 一 个 Intent， 使 用 Android.content.Intent.ACTION_SEND 参数 通过 
手机 寄 发 E-mail 的 服务 ， 整 个 过 程 比 较 简 单 。 在 具体 实现 上 ， 邮 件 的 收发 过 程 是 通过 
Android 内 署 的 Gmail 程序 实现 的 ， 而 并 不 是 使 用 SMTP 的 Protocol。 为 了 确保 邮件 能 够 发 
出 ， 必 须 在 收 件 人 字段 上 输入 标准 的 邮件 地 址 格式 ， 如 果 格 式 不 规范 ， 则 发 送 按钮 处 于 不 
可 用 状态 。 


实例 10-4 调用 内 置 Gmail 发 送 邮 件 下 载 路 径 :\daima\10\DGmail 


本 实例 的 具体 实现 流程 如 下 。 
(1) 编写 布局 文件 main.xml， 主 要 代码 如 下 : 


<TextView 
android:id="@+id/myTextViewl" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:text="@string/str receive" 
android:layout x="60px" 
android:layout y="22px" 

> 

</TextView> 

<TextView 
android:id="@+id/myTextView2" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:text="@string/str cc" 
android:layout x-"60px" 
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android:layout y-"82px" 


> 

</TextView> 

<EditText 
android: id="@+id/myEditText1" 
android:layout width="fill parent" 
android:layout height-"wrap content" 
android:textSize-"18sp" 
android:layout x-"120px" 
android:layout y="12px" 

» 

«/EditText» 

<EditText 


android: id="@+id/myEditText2" 
android:layout width="fill parent" 
android:layout height="wrap content" 
android: textSize="18sp" 
android:layout x="120px" 
android:layout y="72px" 

> 

</EditText> 


<TextView 


android: 

android: 

android: 

android: 

android: 

android: 
> 


id="@+id/myTextView3" 

layout width="wrap content" 
layout height="wrap content" 
text="@string/str subject" 
layout x="60px" 

layout y="142px" 


</TextView> 


<EditText 
android: 
android: 
android: 
android: 
android: 
android: 

= 


id="@+id/myEditText3" 

layout width-"fill parent" 
layout height-"wrap content" 
textSize-"18sp" 

layout x-"120px" 

layout y-"132px" 


«/EditText» 


<EditText 
android: 
android: 
android: 
android: 
android: 
android: 

> 


id="@+id/myEditText4" 
layout width="fill parent" 
layout height="209px" 
textSize="18sp" 

layout x="0px" 

layout y="202px" 


</EditText><Button android:id="@+id/myButton1" 
android:layout width="wrap content" android:layout height="124px" 
android:text="@string/str_ button" android:layout_x="0px" 
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android:layout y-"2px"» 


</Button> 


(2) 编写 主 程序 文件 GMailjava， 其 具体 实现 流程 如 下 。 
引用 content Intent 类 打开 E-mail 客户 端 ， 具 体 代 码 如 下 : 


package irdc.GMail; 


import irdc.GMail.R; 


import java.util.regex.Matcher; 

import java.util.regex.Pattern; 

import android.app.Activity; 

/* 必 须 引 用 content.Intent 类 来 打开 E-mail client*/ 
import android.content.Intent; 

import android.os.Bundle; 

import android.view.KeyEvent; 

import android.view.View; 

import android.widget.Button; 

import android.widget.EditText; 


© 分 别 声明 四 个 EditText、 


件 主体 、 副 本 和 主题 ， 具 体 代码 如 下 : 


public class GMail extends Activity 


{ 


/* 声 明 四 个 EditText、 一 个 Button 以 及 四 个 String 变量 */ 
private EditText mEditText01; 

private EditText mEditText02; 

private EditText mEditText03; 

private EditText mEditText04; 

private Button mButton01; 

private String[] strEmailReciver; 

private String strEmailSubject; 

private String[] strEmailCc; 

private String strEmailBody ; 


/** Called when the activity is first created. */ 


@override 


public void onCreate (Bundle savedInstanceState) 


t 


super.onCreate (savedInstanceState); 
setContentView (R.layout.main); 

/* 通 过 findViewById 构造 器 来 建构 Button 对 象 */ 
mButton0l = (Button) findViewById(R.id.myButton1); 
/* 通 过 findviewById 构造 器 来 构造 所 有 EditText 对 象 */ 
mButton0l.setEnabled (false); 

/*i&'É onKeyListener, *4 key 事件 发 生 时 进行 响应 */ 


mEditText01 = 
mEditText02 
mEditText03 = 
mEditText04 = 


(EditText) findViewById (R.id.myEditText]l); 
(EditText) findViewById (R.id.myEditText2); 
(EditText) findViewById (R.id.myEditText3); 
(EditText) findViewById (R.id.myEditText4); 


-个 Button 以 及 四 个 String 变量 ， 用 于 输入 邮箱 地 址 、 邮 


> Andioid sasaiA nma 


@ 定义 setOnKeyListener 方法 ， 如 果 用 户 输入 为 正规 的 E-mail 文字 ， 则 按钮 可 用 ， 
反之 则 按钮 不 可 用 ， 有 具体 代码 如 下 : 


/* 若 用 户 输入 为 正规 E-mail 文字 ， 则 按钮 可 用 ， 反 之 则 按钮 不 可 用 */ 
mEditText01.setOnKeyListener (new EditText .OnKeyListener () 
{ 
@override 
public boolean onKey(View v, int keyCode, KeyEvent event) 
{ 
// TODO Auto-generated method stub 
/* 如 果 是 邮件 地 址 格式 ， 则 按钮 可 按 下 */ 
if (isEmail (mEditText01.getText() .toString())) 
{ 
mButton01l.setEnabled (true); 
} 
else 
{ 
mButtonOl.setEnabled(false); 
} 
return false; 


D; 
@ EX onClickListener 响应 按钮 ， 当 i 


/* 定 义 onClickListener 响应 按钮 */ 
mButton01.setOnClickListener (new Button.OnClickListener() 
{ 
@override 
public void onClick(View v) 
{ 
// TODO Auto-generated method stub 
Intent mEmailIntent = new Intent (android.content.Intent.ACTION SEND) ; 
mEmailIntent.setType ("plain/text") ; 


按钮 后 实现 邮件 发 送 处 理 。 具 体 代码 如 下 : 


strEmailReciver = new String[] {mEditText01.getText() .tostring()}; 
strEmailCc = new String[] {mEditText02.getText() .toString() }; 
strEmailSubject = mEditText03.getText () .toString(); 

strEmailBody = mEditText04.getText().toString(); 


mEmaillIntent.putExtra (android.content.Intent.EXTRA EMAIL, strEmailReciver) ; 
mEmailIntent.putExtra(android.content.Intent.EXTRA CC, strEmailCc) ; 
mEmailIntent.putExtra (android.content.Intent.EXTRA SUBJECT, 
strEmailSubject); 
mEmailIntent.putExtra (android.content.Intent.EXTRA TEXT, strEmailBody); 
startActivity (Intent.createChooser (mEmailIntent, 
getResources() .getString(R.string.str message))); 


); 
$ 


© 定义 isEmail(String sttrEmail) 方 法 ， 检 查 是 否 为 规范 的 邮件 地 址 格式 。 具 体 代码 如 下 : 
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public static boolean isEmail(String strEmail) 

t 
String strPattern = "^[a-zA-Z] [\\w\\.-]* [a-zA-Z0-9] 8 [a-zA-Z0-9] 

[\\w\\ .-] * [a-zA-Z0-9] NV. [a-zA-Z] [a-ZA-ZNN . ] *[a-zA-Z] $"; 

Pattern p = Pattern.compile (strPattern); 
Matcher m - p.matcher(strEmail); 
return m.matches(); 

H 
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执行 后 的 效果 如 图 10-15. 所 示 ， 输 入 手机 号 码 ， 编 写 短信 内 容 后 ， 单 击 “ 发 送 ”按钮 
即 可 完成 短信 发 送 功能 ， 系 统 会 提示 信息 成 功 ， 如 图 10-16 所 示 。 


发 送 
© 正在 发 信 中 .. 
No applications can perform 
this action. 
A 10-15 执行 效果 图 10-16 ”发 信 中 提示 


因为 Android 模拟 器 中 没有 内 置 Gmail 客户 端 程序 ， 所 以 当 使 用 本 实例 发 送 邮 件 后 ， 
会 显示 “No application can perform this action” 的 提示 。 但 是 在 现实 手机 设备 上 ， 如 果 运 行 
本 实例 程序 ， 会 调用 Gmail 程序 ， 成 功 实现 邮件 发 送 。 


10.16 ”其 他 方法 


还 有 其 他 使 用 Intent 调用 内 置 邮 件 程序 发 送 邮件 的 方法 ， 接 下 来 将 一 一 简要 介绍 。 

(1) 直接 设置 具体 的 E-mail 地 址 ， 例 如 通过 下 面 的 代码 可 以 向 地 址 为 aaa@gmail.com 
的 邮箱 发 送 邮件 。 

Uri uri-Uri.parse ("mailto:aaa@gmail.com") ; 


Intent MymailIntent-new Intent (Intent.ACTION SEND, uri); 
startActivity (MymailIntent); 


Q) 在 使 用 直接 声明 地 址 方式 发 送 邮件 时 ， 可 以 实现 群发 功能 ， 例 如 下 面 的 代码 同时 
向 两 个 邮件 地 址 发 送 邮件 。 


Intent testintent-new Intent(Intent.ACTION SEND); 
String[] tos={"aaa@gmail.com"}; 
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String[] ccs={"bbb@hotmail.com"}; 

testintent .putExtra(Intent.EXTRA EMAIL, tos); 
testintent.putExtra (Intent.EXTRA CC, ccs); 
testintent.putExtra(Intent.EXTRA TEXT, "这 是 内 容 "); 
testintent.putExtra(Intent.EXTRA SUBJECT, "这 是 标题 "); 
testintent.setType ("message/rfc822"); 
startActivity(Intent.createChooser(testintent, "发 送 ") ) ; 


(3) 发 送 有 附件 的 邮件 。 

方法 putExtra() 的 两 个 参数 是 URL 地 址 ， 即 在 传递 时 第 二 个 参数 必须 是 URI 格式 的 ， 
那 就 意味 着 不 能 直接 将 图 片 传送 过 去 ， 而 是 先 要 取得 图 片 的 URI。 在 传送 完毕 后 ，E-mail 
程序 利用 这 个 URI 重新 获取 图 片 。 为 了 获取 URI， 需 要 先 保存 图 片 。 例 如 下 面 的 代码 发 送 
了 附件 为 图 片 的 邮件 。 

/7 创建 保存 文件 

String sdCardDir = Environment.getExternalStorageDirectory ()-*"/cameraApp/"; 

File dirFile - new File(sdCardDir); 


if(!dirFile.exists())( 
dirFile.mkdir(); 


} 
// 创 建 保存 文件 

bitmapFile = new File(dirFile, "Image"+picId+".jpg") ; 
BufferedOutputStream bos = new BufferedOutputStream(new FileOutputStream 
(bitmapFile)); 
Bm.compress (Bitmap.CompressFormat.JPEG, 80, bos); 
bos.flush(); 
bos.close(); 
通过 下 面 的 代码 向 指定 的 地 址 发 送 了 一 幅 图 片 。 
Intent emailIntent = new Intent(Intent.ACTION SEND); 
Uri U-Uri.parse("file:///sdcard/logo.png"); 
emailIntent.putExtra (android.content.Intent.EXTRA EMAIL, "aaae@yahoo.com" 
he 
emailIntent.putExtra (android.content.Intent.EXTRA SUBJECT, "Test"); 
emailIntent.putExtra (android.content.Intent.EXTRA TEXT, "This is email's 
message"); 
emailIntent.setType ("image/png"); 
emailIntent.putExtra(android.content.Intent.EXTRA STREAM, U); 
startActivity(Intent.createChooser(emailIntent, "Email:")); 


通过 下 面 的 代码 发 送 了 附件 为 音乐 文件 的 邮件 。 


Intent testN-new Intent(Intent.ACTION SEND); 
testN.putExtra(Intent.EXTRA SUBJECT, "标题 ") ; 
testN.putExtra(Intent.EXTRA STREAM, "file:///sdcard/music.mp3"); 
startActivity(Intent.createChooser(testN, "发 送 ") ); 


另外 也 可 以 将 附件 作为 File 对 和 象 来 处 理 ， 例 如 下 面 的 代码 : 


File file = new File("\sdcard\android123.cwj"); // 附 件 文件 地 址 
Intent intent = new Intent (Intent.ACTION SEND); 
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intent.putExtra("subject", file.getName()); 
intent.putExtra("body", "android123 - email sender"); MES 
intent.putExtra(Intent.EXTRA STREAM, Uri.fromFile(file)); 


// 添 加 附件 ， 附 件 为 file 对 象 
if (file.getName().endsWith(".gz")) { 
intent.setType("application/x-gzip"); // 如 果 是 gz 使 用 gzip 的 mime 
) else if (file.getName().endsWith(".txt")) ( 
intent.setType("text/plain"); // 纯 文本 则 用 text/plain 的 mime 
) else ( 
intent.setType ("application/octet-stream"); 
// 其 他 的 均 使 用 流 当 作 二 进 制 数据 来 发 送 
} 


startActivity(intent); // 调 用 系统 的 mail 客户 端 进行 发 送 


10.2 使 用 SmsManager 收发 邮件 


在 Android 系统 中 ， 除 了 可 以 使 用 Intent 调用 内 置 邮件 系统 发 送 邮 件 外 ， 还 可 以 使 用 
类 SmsManager 来 收发 邮件 。 本 节 将 详细 讲解 使 用 SmsManager 实现 邮件 收发 的 基本 知识 。 


10.2.1 


SmsManager 基 础 


TE Android FAF, X SmsManager 是 用 来 管理 短信 服务 操作 的 ， 例 如 发 送 数据 、 文 
本 和 数据 单元 等 短信 服务 消息 。 可 以 通过 调用 SmsManager.getDefault() 来 获取 SmsManager 


WH. 


1. SmsManagerf = & 
类 SmsManager 中 的 常量 如 下 。 


a 


a 


public static final int RESULT ERROR GENERIC FAILURE: 表示 普通 错误 ， 值 
为 1(0x00000001). 

public static final int RESULT ERROR NO SERVICE: 表示 服务 当前 不 可 用 ， 值 
为 4 (0x00000004). 

public static final int RESULT ERROR NULL PDU: 表示 没有 提供 pdu， 值 为 3 
(0x00000003). 

public static final int RESULT ERROR RADIO OFF: 表示 无 线 广播 被 明确 地 关 
H]. {4% 2 (0x00000002). 

public static final int STATUS ON ICC FREE: 表示 自由 空间 ， 值 为 0 
(0x00000000). 
public static final int STATUS ON ICC READ: 表示 接收 且 已 读 ， 值 为 1 
(0x00000001). 

public static final int STATUS ON ICC SENT: 表示 存储 且 已 发 送 ， 值 为 5 
(0x00000005). 
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Q public static final int STATUS ON ICC UNREAD: 表示 接收 但 未 读 ， 值 为 3 
(0x00000003). 

Q public static final int STATUS ON ICC UNSENT: 表示 存储 但 未 发 送 ， 值 为 7 
(0x00000007). 


2. SmsManager 的 公有 方法 


1) ArrayList<String> divideMessage(String text) 

功能 : 当 短 信 超 过 SMS 消息 的 最 大 长 度 时 ， 将 短信 分 割 为 几 块 。 

参数 : text， 初 始 的 消息 ， 不 能 为 空 。 

返回 值 : 有 序 的 ArrayList<String>， 可 以 重新 组 合 为 初始 的 消息 。 

2) static SmsManager getDefault() 

功能 : 获取 SmsManager 的 默认 实例 。 

返回 值 : SmsManager 的 默认 实例 。 

3) void SendDataMessage(String destinationAddress, String scAddress, short destinationPort, 
byte[] data, PendingIntent sentIntent, PendingIntent deliveryIntent) 

功能 : 发 送 一 个 基于 SMS 的 数据 到 指定 的 应 用 程序 端口 。 

参数 如 下 。 
destinationAddress: 消息 的 目标 地 址 。 
scAddress: 服务 中 心 的 地 址 若 为 空 ， 使 用 当前 默认 的 SMSC。 
destinationPort: 消息 的 目标 端口 号 。 
data: 消息 的 主体 ， 即 消息 要 发 送 的 数据 。 
sentIntent: 如 果 不 为 空 ， 当 消息 成 功 发 送 或 失败 ， 这 个 PendingIntent 就 广播 。 如 
果 代 人 码 是 Activity.RESULT_ OK 表示 成 功 ， 或 RESULT ERROR GENERIC 
FAILURE, RESULT ERROR RADIO OFF, RESULT ERROR NULL PDU 之 一 
表示 错误 。 对 应 RESULT ERROR GENERIC FAILURE, sentIntent. 可 能 包括 额 
外 的 “错误 代码 ”， 包 含 一 个 无 线 电 广播 技术 特定 的 值 ， 通 常 只 在 修复 故障 时 有 
用 。 每 一 个 基于 SMS 的 应 用 程序 控制 检测 sentIntent。 如 果 sentIntent 为 空 ， 调 用 
者 将 检测 所 有 未 知 的 应 用 程序 ， 这 将 导致 在 检测 的 时 候 发 送 较 小 数量 的 SMS。 

Q deliveryIntent: 如 果 不 为 空 ， 当 消息 成 功 传送 到 接收 者 ， 这 个 PendingIntent 就 广播 。 

异常 : 如 果 destinationAddress 或 data 是 空 时 ， 抛 出 IllegalArgumentException 异常 。 

4) void sendMultipartTextMessage(String destinationAddress, String scAddress, ArrayList 
«String? parts, ArrayList<PendingIntent> sentIntents, ArrayList<PendingIntent> deliverIntents) 

功能 : 发 送 一 个 基于 SMS 的 多 部 分 文本 ， 调 用 者 已 经 通过 调用 divideMessage(String 
texb 将 消息 分 割 成 正确 的 大 小 。 

参数 如 下 。 

口 destinationAddress: 消息 的 目标 地 址 。 

Q scAddress: 服务 中 心 的 地 址 若 为 空 ， 使 用 当前 默认 的 SMSC. 

Q parts: 有 序 的 ArrayList<String>， 可 以 重新 组 合 为 初始 的 消息 。 

口 ”sentIntents: 与 SendDataMessage 方法 中 的 含义 一 样 ， 只 不 过 这 


oooco 


um 


有 指 的 是 一 组 
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PendingIntent. 
ū deliverIntents: 与 SendDataMessage 方法 中 的 含义 一 样 ， 只 不 过 这 里 指 的 是 一 组 
PendingIntent. 
异常 : 如 果 destinationAddress 或 data 为 空 时 ， 抛 出 IlegalArgumentException 异常 。 
void sendTextMessage(String destinationAddress, String scAddress, String text, PendingIntent 
sentIntent, Pendingintent deliveryIntent) 
功能 : 发 送 一 个 基于 SMS 的 文本 。 参 数 的 意义 和 异常 和 前 面 的 几 个 方法 是 一 样 的 ， 
在 此 不 再 袭 述 。 


10.2.2 使 用 SmsManager 发 送 短 信 


实 例 功 能 源码 路 径 


实例 10-5 使 用 SmsManager 发 送 短 信 下 载 路 径 :\daima\10\jiandan 


在 本 实例 中 ， 定 义 了 两 个 EditText 控件 ， 分 别 用 于 获取 收 信人 电话 和 短信 正文 ， 并 设 
置 判 断 手 机 号 码 规范 化 的 方法 和 短信 的 字数 不 超过 70 个 字符 。 

在 具体 实现 上 ， 是 通过 SmsManage 对 象 的 sendTextMessage() 方 法 来 完成 的 。 在 
sendTextMessage() 方 法 中 要 传 入 5 个 值 ， 分 别 是 : 收 件 人 地 址 String、 发 送 地 址 String, IE 
文 String、 发 送 服务 PendingIntent 和 送 达 服务 PendingIntent。 本 实例 的 具体 实现 流程 如 下 。 

(1) 编写 布局 文件 main.xml， 主 要 代码 如 下 : 


<TextView 
android:id="@+id/widget27" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text-"G(string/str textview" 
android:textSize-"l6sp" 
android:layout x-"Opx" 
android:layout y="12px" 

= 

</TextView> 

<EditText 
android: id="@+id/myEditText1" 
android:layout width="fill parent" 
android:layout height="wrap content" 
android:text="" 
android: textSize="18sp" 
android:layout x="60px" 
android:layout y="2px" 

D 

«/EditText» 

«EditText 
android: id="@+id/myEditText2" 
android:layout width="fill parent" 
android:layout height="223px" 
android:text="" 
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android:textSize-"18sp" 


android:layout x="0px" 
android:layout y-"52px" 

> 

</EditText> 

<Button 
android: id="@+id/myButton1" 
android:layout width="162px" 
android:layout height="wrap content" 
android:text="@string/str buttonl" 
android:layout x="80px" 
android:layout y-"302px" 

» 

«/Button» 


Q) 编写 主 程序 文件 jiandanjava， 其 具体 实现 流程 如 下 。 
© 引用 dingIntent 类 和 telephony.gsm.SmsManager 类 ， 具 体 代码 如 下 : 


package irdc.jiandan; 


import android.app.Activity; 

/* 引 用 PendingIntent 类 才能 使 用 getBrocast () */ 
import android.app.PendingIntent; 

import android.content.Intent; 

import android.os.Bundle; 

/x* 引 用 telephony.gsm.SmsManager 类 才能 使 用 sendTextMessage () */ 
import android.telephony.gsm.SmsManager; 
import android.view.View; 

import android.widget.Button; 

import android.widget.EditText; 

import android.widget.Toast; 

import irdc.jiandan.R; 


import java.util.regex.Matcher; 
import java.util.regex.Pattern; 


© 声明 变量 : 一 个 Button 和 两 个 EditText. EditText 供 获取 输入 收 信人 电话 号 码 和 短 
信 内 容 ，Button 用 于 激活 发 信 处 理 程序 。 具 体 代 码 如 下 : 


public class jiandan extends Activity 
t 
/* 声 明 变 量 : 一 个 Button 与 两 个 EditText*/ 
private Button mButtonl; 
private EditText mEditTextl; 
private EditText mEditText2; 


/** Called when the activity is first created. */ 
@override 
public void onCreate (Bundle savedInstanceState) 
{ 
super .onCreate (savedInstanceState); 
setContentView(R. layout .main) ; 
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/* 
* 通过 findViewById 构造 器 来 建构 

* EditTextl. EditText2 与 Button 对 象 

enl 

mEditTextl (EditText) findViewById(R.id.myEditText1l); 
mEditText2 = (EditText) findViewById(R.id.myEditText2) ; 
mButtonl = (Button) findViewById(R.id.myButtonl); 


/* 将 默认 文字 加 载 到 EditText 中 */ 
mEditTextl.setText (" 请 输入 号 码 ") ; 
mEditText2.setText ("请 输入 内 容 !!"); 


/* 设 置 onClickListener 让 用 户 点 击 EditText 时 做 出 反应 */ 
mEditText1.setOnClickListener (new EditText.OnClickListener() 


{ 
public void onClick(View v) 


{ 
/* 点 击 EditText 时 清空 正文 */ 
mEditTextl.setText (""); 
} 
} 
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®© 设置 onClickListener() 方 法 ， 用 于 响应 用 户 点 击 EditText 时 做 出 反应 。 具 体 代码 
如 下 : 


/* 设 置 onclickListener 让 用 户 点 击 EditText 时 做 出 响应 */ 
mEditText2.setOnClickListener(new EditText.OnClickListener () 
{ 
public void onClick(View v) 
{ 
/* Aih EditText 时 清空 正文 */ 
mEditText2.setText (""); 
) 


} 
); 

@ 设置 onClickListener 方法 ， 功 能 是 用 户 点 击 Button 时 做 出 响应 ， 有 具体 代码 如 下 : 
/*i&'É onclickListener 让 用 户 点 击 Button 时 做 出 响应 */ 


mButtonl.setOnClickListener(new Button.OnClickListener () 
{ 
@override 
public void onClick(View v) 
{ 
/*tH EditText1 取得 短信 收 件 人 电话 */ 
String strDestAddress = mEditTextl.getText().toString(); 
/* 由 EditText2 取得 短信 文字 内 容 */ 
String strMessage = mEditText2.getText().toString(); 
/* 建 构 一 取得 default instance 的 SmsManager 对 象 */ 
SmsManager smsManager = SmsManager.getDefault (); 
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// TODO Auto-generated method stub 


© 检查 收 件 人 电话 格式 与 短信 字数 是 否 超过 70 字符 ， 通 过 smsManager.sendTextMessage 
实现 发 送 短信 处 理 ， 具 体 实现 代码 如 下 : 


/* 检 查收 件 人 电话 格式 与 短信 字数 是 否 超过 70 字符 */ 
if(isPhoneNumberValid (strDestAddress)--true && 
iswithin70 (strMessage) ==true) 
{ 
try 
{ 
/* 
* 两 个 条 件 都 检查 通过 的 情况 下 ， 发 送 短信 
* 先 建构 一 个 PendingIntent 对 象 并 使 用 getBroadcast () 广播 
* 将 PendingIntent、 电 话 、 短 信 文 字 等 参数 
* 传 入 sendTextMessage () 方 法 发 送 短信 
xg 
PendingIntent mPI = PendingIntent.getBroadcast 
(jiandan.this, 0, new Intent(), 0); 
smsManager.sendTextMessage 
(strDestAddress, null, strMessage, mPI, null); 
} 
catch (Exception e) 
{ 
e.printStackTrace(); 
} 
Toast .makeText 
( 
jiandan.this, "送出 成 功 !!" , 
Toast.LENGTH SHORT 
)-show(); 
mEditTextl.setText (""); 
mEditText2.setText (""); 
$ 
else 


t 
/* 电话 格式 与 短信 文字 不 符合 条 件 时 ， 以 Toast 提醒 */ 
if (isPhoneNumberValid (strDestAddress)--false) 
{ /* 且 字数 超过 70 字符 */ 
if (iswithin70 (strMessage) ==false) 
{ 
Toast .makeText 
( 
jiandan.this, 
"电话 号 码 格式 错误 + 短信 内 容 超过 70 字 , 请 检查 ! 1!1"， 
Toast.LENGTH SHORT 
)-show(); 
H 
else 


t 
Toast.makeText 


) 
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( 
jiandan.this, 
"电话 号 码 格式 错误 , 请 检查 !!" ， 
Toast.LENGTH SHORT 
) .show(); 
} 


} 
/* 字 数 超过 70 字符 */ 
else if (iswithin70 (strMessage)--false) 
{ 
Toast .makeText 
( 
jiandan.this, 
"短信 内 容 超 过 70 F, 请 删除 部 分 内 容 !!1"， 
Toast.LENGTH SHORT 
)-show(); 
} 
} 
} 


5 


) 
/* 检 查 字 符 串 是 否 为 电话 号 码 的 方法 ， 并 返回 true or false 的 判断 值 */ 
public static boolean isPhoneNumberValid(String phoneNumber) 


{ 


boolean isValid = false; 


JS 


* 


+ 


es 


* 
e 
St. 


"^ 


/* 


可 接受 的 电话 格式 有 : 

AAN : 可 以 使 用 “(” 作 为 开头 

(\\d{3}) : 紧 接着 三 个 数字 

Ww)? : 可 以 使 用 “) ”接续 

[- ]? : 在 上 述 格式 后 可 以 使 用 具 选 择 性 的 “-” 

(\\d{3}) : 再 紧 接 着 三 个 数字 

[- ]? : 可 以 使 用 具 选 择 性 的 “-” 接 续 

(\\q{5})$: 以 五 个 数字 结束 

可 以 比较 下 列 数字 格式 : 

(123) 456-7890, 123-456-7890. 1234567890. (123)-456-7890 


ring expression = 
NN(2(NN343)) NO) 2 [7 12(N3(3)) [= 12(0N3(5)) $7; 


可 接受 的 电话 格式 有 : 


* A\\(2 可 以 使 用 (0 作 为 开关 


dd 
GE 


(\\d{3}) : 紧 接着 三 个 数字 

\\)? : 可 以 使 用 “) ”接续 

[- ]? : 在 上 述 格式 后 可 以 使 用 具 选 择 性 的 “-” 

(\\d({4}) : 再 紧 接着 四 个 数字 

[- ]? : 可 以 使 用 具 选 择 性 的 “-” 接 续 

(\\d{4}) $S: 以 四 个 数字 结束 

可 以 比较 下 列 数字 格式 : 

(02) 3456-7890, 02-3456-7890. 0234567890. (02)-3456-7890 


ring expression2- 
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CharSequence inputStr = phoneNumber; 
/*8j£t Pattern*/ 
Pattern pattern = Pattern.compile (expression); 
/+* 将 Pattern 以 参数 传 入 Matcher fF Regular expression*/ 
Matcher matcher = pattern.matcher (inputStr); 
/+ 创建 Pattern2*/ 
Pattern pattern2 -Pattern.compile (expression2); 
/+* 将 Pattern2 以 参数 传 入 Matcher2 ff Regular expression*/ 
Matcher matcher2- pattern2.matcher (inputStr); 
if (matcher.matches () | |matcher2.matches()) 
t 
isValid - true; 
} 
return isValid; 
) 


public static boolean iswithin70 (String text) 
t 
if (text.length()<= 70) 
t 
return true; 
) 
else 
t 
return false; 
b 
) 
) 


在 上 述 代 码 中 ， 通 过 方法 PendingIntent.getBroadcast() H EX T PendingIntent 并 进行 
Broadcast 广播 ， 然 后 使 用 SmsManager.getDefault() 预 先 构建 的 SmsManager 对 象 ， 并 使 用 
sendTextMessage() 方 法 将 有 关 的 数据 以 参数 形式 带 入 ， 这 样 即 可 完成 发 短信 的 任务 。 

执行 后 的 效果 如 图 10-17 所 示 。 输 入 手机 号 码 ， 编 写 短信 内 容 后 ， 单 击 “ 发 送 ”按钮 
即 可 完成 短信 发 送 功能 。 系 统 会 提示 成 功 信息 ， 如 图 10-18 所 示 。 


| 请 输入 号 码 


请 输入 内 容 !! 


图 10-17 执行 效果 10-18 ”发 送 成 功 
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如 果 短 信 内 容 和 收 信人 号 码 格式 不 规范 ， 会 输出 对 应 的 错误 提示 。 


10.2.3 ”解决 Android 邮 件 附 件 中 文 名 乱码 问题 


邮件 附件 名 的 编码 与 邮件 名 的 编码 可 以 如 出 一 略 。 因 为 多 功能 Internet 邮件 扩充 服务 
协议 ， 即 MIME(Multipurpose Internet Mail Extensions) 对 附件 名 的 规定 是 US-ASCII( 应 该 也 
是 ASCID， 所 以 该 乱码 bug 的 出 现 与 Java 和 Android 无 关 ， 是 由 于 MIME 的 不 规范 。 

邮件 的 标题 用 了 一 种 更 简短 的 格式 来 标注 “字符 编码 ”和 “传输 编码 ”。 比 如 ， 标 题 
内 容 为 “中 ”， 则 在 邮件 源 代码 中 表示 为 “=?GB2312?B?1tA=?= ”， 其 中 第 一 个 “=?” 
与 “?” 中 间 的 部 分 指定 了 字符 编码 ， 在 这 个 例子 中 指定 的 是 GB2312。“?” 与 “?” 中 间 
的 “B” 代 表 Base64。 如 果 是 “Q” 则 代表 Quoted-Printable。 最 后 “?” 与 “?=” 之 间 的 
部 分 ， 就 是 经 过 GB2312 转化 成 字 节 串 ， 再 经 过 Base64 转化 后 的 标 是 内容。 如果“ 传输 
编码 ” 改 为 Quoted-Printable， 同 样 ， 若 标题 内 容 为 “中 ”， 则 : 

// 正确 的 标题 格式 

Subject: =?GB2312?Q?=D6=D0?= 

如 果 阅 读 邮 件 时 出 现 乱 码 ， 一 般 是 因为 “字符 编码 ”或 “传输 编码 ”指定 有 误 ， 或 者 
是 没有 指定 。 比 如 ， 有 的 发 邮件 组 件 在 发 送 邮 件 时 ， 标 题 “ 中 ”: 

// 错误 的 标题 格式 

Subject: -?180-8859-1?9?-D6-D0?- 

这 样 的 表示 ， 实 际 上 是 明确 指明 了 标题 为 [OxO0D6, 0x00D0]， 即 “OD”， 而 不 是 
ic uer 

根据 上 面 的 解释 ， 那 么 解决 乱码 就 没有 问题 了 。 在 我 们 找到 读 取 附件 名 的 地 方 ， 如 
mFileName， 位 于 Email/provider/EmailContent.java， 首 先 对 其 进行 base64Encode 编码 : 
String name = com.android.email.Utility.base64Encode(mFileName)， 然 后 强制 给 name 添加 编 
码头 和 尾 : String name2 = "=?utf8?B?" + name +"?="。 这 样 接 收 邮件 的 客户 端 在 检测 到 
“=?utf8?B?” 的 时 候 ， 会 对 字符 串 进行 base64 和 UTF-8 的 转 码 ， 乱 码 将 不 再 出 现 。 


10.3 ”使 用 包 commons-mail.jar 和 mail.jar 


commons-mailjar 和 mailjar 是 Java 中 两 个 比较 重要 的 包 ， 前 者 的 功能 是 实现 邮件 发 
送 ， 后 者 的 功能 是 实现 邮件 接收 。 在 Android 系统 应 用 中 ， 可 以 使 用 这 两 个 包 来 编写 收发 
邮件 程序 。 


10.3.1 使 用 commons-mailjar 发 送 邮件 
对 于 包 commons-mailjar 的 使 用 方法 ， 相 信和 只 要 学 过 Java 的 读者 都 会 有 印象 。 本 书 将 


不 再 介绍 它 的 用 法 ， 而 直接 用 演示 代码 来 讲解 其 用 法 。 使 用 commons-mailjar 发 送 邮件 的 
基本 流程 如 下 。 
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(1) 定义 mail 的 一 个 Bean， 例 如 下 面 的 代码 ; 


public class Mail ( 
private String toAddress; // 邮件 接收 者 
private String nickname; // 收 件 人 昵称 
private String subject; // 邮件 主题 
private String content; // 邮件 内 容 
private String ChartSet; // 字 符 集 
private Map<String, String> AttachmentsPath;  // 附 件 路 径 列 表 
/////setter() and getter()... 
} 


(2) 实现 发 送 文 本 形式 的 邮件 。 设 置 接收 者 邮箱 的 信息 参数 ， 接 下 来 就 可 以 不 断 发 送 
而 无 须 再 定义 。 例 如 下 面 的 代码 : 


public class TextMailSender { 


private String hostname; 

private String username; 

private string password; 

private String address; 

private Boolean TLS; 

public TextMailSender(String hostname, String address, String 
username, String password, Boolean TLS) ( 
this.hostname - hostname; 
this.username - username; 
this.password = password; 
this.address - address; 
this.TLS = TLS; 

) 

public void execute(Mail mail) throws EmailException( 


SimpleEmail email = new SimpleEmail(); 
email .setTLS (TLS); 
email .setHostName (hostname); 


email.setAuthentication(username, password) ; // 用 户 名 和 密码 
email.setFrom(address); // 发 送 地 址 
email.addTo (mail.getToAddress()); // 接收 地 址 
email.setSubject (mail.getSubject ()); // 邮件 标题 
email.setCharset (mail.getChartSet()); 

email.setMsg (mail.getContent ()); // 邮件 内 容 


email.send(); 
) 
public static void main(String[] args) ( 
TextMailSender sender = new TextMailSender ("smtp.qq.com", 
B cesniequecom?; s cosud d ORROKd x Cue) i>, 


Mail mail - new Mail(); 
mail.setToAddress ("cesul@qq.com") ; 


mail.setSubject (" 这 又 是 一 封 测试 邮件 ! n); 
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mail.setContent (" 阿 呵呵 呵呵 ") ; 
mail.setChartSet ("utf-8"); 


try 


{ 
sender.execute (mail); 


) catch (EmailException e) { 


) 


e.printStackTrace(); 


System.out.println ("Finished"); 


) 


(3) 使 用 commons-mail 定义 另 一 个 类 ， 实 现 添加 多 个 附件 的 功能 。 例 如 下 面 的 演示 


代码 : 


public class AttachmentSender { 


private 
private 
private 
private 
private 
private 


String hostname; //"SMTP 服务 器 " 
String username; 

String password; 

String address; 

String nickname; 

Boolean TLS; 


public AttachmentSender (String hostname, String address, String 
nickname, String username, String password, Boolean TLS) ( 
this.hostname - hostname; 
this.nickname - nickname; 
this.username - username; 
this.password - password; 
this.address - address; 
this.TLS = TLS; 


@suppressWarnings ("unchecked") 

public void execute (Mail mail) throws UnsupportedEncodingException, 
EmailException( 
// Create the email message 
MultiPartEmail email = new MultiPartEmail(); 
email.setHostName (hostname); 
email.setAuthentication (username, password); 
email.setFrom(address, nickname);  // 可 以 加 入 发 信人 称呼 
email.setTLS(TLS); 


email.setCharset (mail.getChartSet ()); 

email.addTo (mail.getToAddress(), mail.getNickname()); 
email.setSubject (mail.getSubject()); 

email.setMsg (mail.getContent ()); 


EmailAttachment attachment; 
// 附 件 是 多 个 ， 遍 历 


Iterator«? extends Object» it 


mail.getAttachmentsPath(). 
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entrySet().iterator(); 
while (it.hasNext()) ( 
Map.Entry«String, String» entry = (Map.Entry«String, 
String»)it.next(); 
attachment = new EmailAttachment () ; 
attachment.setPath(entry.getKey()); // 键 是 附件 路 径 
attachment .setDisposition (EmailAttachment .ATTACHMENT) ; 
attachment .setDescription (MimeUtility.encodeWord ("附件 ", "UTF- 
at nurty) 
// 值 是 附件 描述 名 
attachment.setName (MimeUtility.encodeWord (entry.getValue(), 
"UTF-8",null)); 
email.attach(attachment);  // add the attachment 
} 
email.send() ; // 开始 发 送 


public static void main(String[] args) ( 


AttachmentSender sender = new AttachmentSender ("smtp.qq.com", 
"cesuleqq.com"，" 陈 志 钊 "， "cesul", "******", true); 


Mail mail = new Mail(); 

mail.setToAddress ("cesul@qq.com") ; 
mail.setNickname (" 你 好 ") ; 

mail.setSubject("Here is the picture you wanted"); 
mail.setContent (" 阿 呵呵 呵呵 ") ; 

mail.setChartSet ("utf-8"); 


Map<String, String» attachment = new HashMap<String, String>(); 
attachment .put ("E:\\Photos\\2123.bmp"，" 这 是 你 要 的 图 片 .bmp") ; 
attachment .put ("E:\\Photos\N\456.bmp"，" 这 也 是 你 要 的 图 片 .bmp") ; 

// 不 要 把 相同 路 径 的 文件 发 两 次 
mail.setAttachmentsPath (attachment); 


try ( 
sender.execute (mail); 

) catch (UnsupportedEncodingException e) ( 
e.printStackTrace(); 

) catch (EmailException e) ( 
e.printStackTrace(); 

} 

System.out.println ("Finished"); 


) 
经 过 上 述 流程 ， 就 实现 了 邮件 发 送 功能 。 
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10.3.2 ”使 用 mailjar 接 收 邮件 


mailjar 包 比 较 强 大 ， 但 是 使 用 方法 却 比较 麻烦 。 笔 者 本 着 无 私 奉献 的 精神 和 传道 解 惑 
的 目的 ， 决 定 将 辛 辛 苦 苦 编写 的 实用 资料 无 偿 奉 献 给 读者 。 希 望 读者 以 此 为 基础 ， 既 可 以 
直接 使 用 ， 也 可 以 继续 升级 。 

下 面 是 通过 mail jar 实现 对 邮件 进行 读 取 的 代码 。 


package org.mail.core; 


import 
import 
import 
import 
import 


public 


java.io.*; 
java.text.*; 
java.util.*; 
javax.mail.*; 
javax.mail.internet.*; 


class ReceiveMail ( 


private MimeMessage mimeMessage - null; 

private String saveAttachPath - ""; // 附件 下 载 后 的 存放 目录 
private StringBuffer bodytext = new StringBuffer(); 

// 存放 邮件 内 容 的 StringBuffer 对 象 

private String dateformat = "yy-MM-dd HH:mm"; // 默认 的 日 前 显示 格式 
/* 构 造 函 数 ， 初 始 化 一 个 MimeMessage 对 象 */ 


public ReceiveMail() { 


} 


public ReceiveMail (MimeMessage mimeMessage) { 


} 


this.mimeMessage = mimeMessage; 
System.out.println("create a ReceiveMail object........ "m 


public void setMimeMessage (MimeMessage mimeMessage) ( 


this.mimeMessage = mimeMessage; 


) 
/* 获得 发 件 人 的 地 址 和 姓名 */ 
public String getFrom() throws Exception ( 


} 


/[** 


InternetAddress address[] - (InternetAddress[]) mimeMessage.getFrom(); 


String from = address[0].getAddress(); 
if (from == null) 
from — ""; 
String personal = address[0].getPersonal(); 
if (personal null) 
personal 4p 
String fromaddr = personal + "«" + from + ">"; 
return fromaddr; 


* * 获得 邮件 的 收 件 人 、 抄 送 和 密 送 的 地 址 和 姓名 ， 根 据 所 传递 参数 的 不 同 


* 


* 


“to”---- 收 件 人 ; “cc”--- 抄 送 人 地 址 ; 
“bcc”--- 密 送 人 地 址 
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iv) 


public String getMailAddress(String type) throws Exception { 
String mailaddr - ""; 
String addtype = type.toUpperCase(); 
InternetAddress[] address - null; 
if (addtype.equals("TO") || addtype.equals ("CC") 
|| addtype.equals("BCC")) { 
if (addtype.equals("TO")) { 
address = (InternetAddress[]) mimeMessage 
.getRecipients (Message.RecipientType.TO); 
) else if (addtype.equals("CC")) ( 
address = (InternetAddress[]) mimeMessage 
-getRecipients (Message.RecipientType.CC); 
) else ( 
address - (InternetAddress[]) mimeMessage 
.getRecipients (Message.RecipientType.BCC); 
) 
if (address != null) { 
for (int i = 0; i « address.length; i++) { 
String email - address[i].getAddress(); 


if (email -- null) 
email = ""; 
else ( 


email = MimeUtility.decodeText (email); 
) 
String personal - address[i].getPersonal(); 


if (personal == null) 
personal - ""; 
else { 


personal - MimeUtility.decodeText (personal); 
H 
String compositeto = personal + "«" + email + ">"; 
mailaddr += "," + compositeto; 
} 
mailaddr = mailaddr.substring (1); 
} 
} else { 
throw new Exception("Error emailaddr type!"); 
} 
return mailaddr; 


/* 获得 邮件 主题 */ 


public String getSubject() throws MessagingException { 
String subject - ""; 
try ( 
subject = MimeUtility.decodeText (mimeMessage.getSubject ()); 
if (subject == null) 
subject = ""; 
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) catch (Exception exce) ( 
} 
return subject; 

) 


/* 获 得 邮件 发 送 日 期 */ 

public String getSentDate() throws Exception { 
Date sentdate = mimeMessage.getSentDate(); 
SimpleDateFormat format = new SimpleDateFormat (dateformat) ; 
return format.format (sentdate); 


} 

/* 获 得 邮件 正文 内 容 */ 

public String getBodyText() ( 
return bodytext.toString(); 

) 


/x* 解 析 邮 件 ， 把 得 到 的 邮件 内 容 保存 到 一 个 StringBuffer 对 象 中 ， 解 析 邮 件 。 主 要 是 根据 
MimeType 类 型 的 不 同 执行 不 同 的 操作 ， 一 步 一 步 地 解析 */ 
public void getMailContent(Part part) throws Exception ( 
String contenttype = part.getContentType(); 
int nameindex = contenttype.indexOf ("name"); 
boolean conname - false; 
if (nameindex !- -1) 
conname - true; 
System.out.println("CONTENTTYPE: " + contenttype); 
if (part.isMimeType("text/plain") && !conname) ( 
bodytext.append((String) part.getContent ()); 
) else if (part.isMimeType("text/html") && !conname) { 
bodytext.append((String) part.getContent ()); 
) else if (part.isMimeType ("multipart/*")) { 
Multipart multipart = (Multipart) part.getContent (); 
int counts = multipart.getCount (); 
for (int i = 0; i < counts; i++) { 
getMailContent (multipart .getBodyPart (i) ); 
} 
) else if (part.isMimeType ("message/rfc822")) { 
getMailContent((Part) part.getContent ()); 
) else ( 
} 
} 


/* 判 断 此 邮件 是 否 需要 回执 ， 如 果 需 要 回执 则 返回 true, FURE false*/ 
public boolean getReplySign() throws MessagingException ( 
boolean replysign - false; 
String needreply[] mimeMessage 
-getHeader ("Disposition-Notification-To"); 
if (needreply != null) ( 
replysign - true; 


} 
return replysign; 
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/* 获 得 此 邮件 的 Message-ID*/ 

public String getMessageId() throws MessagingException { 
return mimeMessage.getMessageID(); 

} 


/* 判 断 此 邮件 是 否 已 读 ， 如 果 未 读 则 返回 false, FURE true*/ 
public boolean isNew() throws MessagingException ( 
boolean isnew = false; 
Flags flags = ((Message) mimeMessage).getFlags(); 
Flags.Flag[] flag = flags.getSystemFlags(); 
System.out.println("flags's length: " + flag.length); 
for (int i = 0; i « flag.length; i++) ( 
if (flag[i] == Flags.Flag.SEEN) ( 
isnew = true; 
System.out.println("seen Message....... nau: 
break; 


) 
return isnew; 


) 
/* 判 断 此 邮件 是 否 包含 附件 */ 
public boolean isContainAttach(Part part) throws Exception { 
boolean attachflag - false; 
String contentType = part.getContentType(); 
if (part.isMimeType ("multipart/*")) ( 
Multipart mp = (Multipart) part.getContent (); 
for (int i = 0; i < mp.getCount(); i++) { 
BodyPart mpart = mp.getBodyPart (i); 
String disposition = mpart.getDisposition(); 
if ((disposition != null) 
&& ((disposition.equals(Part.ATTACHMENT)) | | 
(disposition.equals (Part .INLINE) ) )) 
attachflag = true; 
else if (mpart.isMimeType("multipart/*")) { 
attachflag = isContainAttach((Part) mpart); 
} else { 
String contype = mpart.getContentType(); 
if (contype.toLowerCase().indexOf ("application") != -1) 
attachflag = true; 
if (contype.toLowerCase().indexOf("name") != -1) 
attachflag = true; 


} 
} else if (part.isMimeType ("message/rfc822")) { 
attachflag = isContainAttach((Part) part.getContent ()); 
} 
return attachflag; 
} 


/* 保 存 附件 */ 
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public void saveAttachMent(Part part) throws Exception ( 
String fileName = ""; 
if (part.isMimeType ("multipart/*")) ( 
Multipart mp = (Multipart) part.getContent (); 
for (int i = 0; i < mp.getCount(); i++) { 
BodyPart mpart = mp.getBodyPart (i); 
String disposition = mpart.getDisposition(); 
if ((disposition != null) 
&& ((disposition.equals(Part.ATTACHMENT)) | | 
(disposition.equals(Part.INLINE)))) { 
fileName = mpart.getFileName(); 
if (fileName .toLowerCase() .indexOf ("gb2312") != -1) { 
fileName = MimeUtility.decodeText (fileName) ; 
} 
saveFile(fileName, mpart.getInputStream()); 
) else if (mpart.isMimeType ("multipart/*")) ( 
saveAttachMent (mpart) ; 
} else { 
fileName = mpart.getFileName(); 
if ((fileName != null) 
&& (fileName.toLowerCase() .indexOf ("GB2312") != -1)) { 
fileName = MimeUtility.decodeText (fileName) ; 
saveFile(fileName, mpart.getInputStream()); 


) 
) else if (part.isMimeType ("message/rfc822")) ( 


saveAttachMent ((Part) part.getContent ()); 


/* 设 置 附件 存放 路 径 */ 
public void setAttachPath(String attachpath) { 
this.saveAttachPath - attachpath; 


/* 设 置 日 期 显示 格式 */ 
public void setDateFormat(String format) throws Exception ( 
this.dateformat = format; 


/* 获 得 附件 存放 路 径 */ 
public String getAttachPath() ( 
return saveAttachPath; 


/* 真 正 地 保存 附件 到 指定 目录 里 */ 


private void saveFile(String fileName, InputStream in) throws Exception { 
String osName = System.getProperty ("os.name"); 
String storedir = getAttachPath(); 


String separator = ""; 
if (osName — null) 
osName = ""; 
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if (osName.toLowerCase().indexOf ("win") != -1) { 
separator = "//"; 
if (storedir == null || storedir.equals("")) 
storedir = "c://tmp"; 
} else { 
separator = "/"; 
storedir = "/tmp"; 
) 


File storefile = new File(storedir + separator + fileName); 
System.out.println("storefile's path: " + storefile.toString()); 
BufferedOutputStream bos - null; 
BufferedInputStream bis - null; 
Ery 

bos = new BufferedOutputStream (new FileOutputStream(storefile)); 


bis = new BufferedInputStream (in); 
int c; 
while ((c = bis.read()) != -1) ( 


bos.write(c); 
bos.flush(); 
) 
) catch (Exception exception) ( 
exception.printStackTrace(); 
throw new Exception ("文件 保存 失败 !1"); 
} finally { 
bos.close(); 
bis.close(); 
} 
) 
/*ReceiveMail 类 测试 */ 
public static void main(String args[]) throws Exception { 
String host = "pop.163.com"; 
String username = "demo"; // 您 的 邮箱 用 户 名 
String password = "******"; // 您 的 邮箱 密码 
Properties props = new Properties(); 
Session session = Session.getDefaultInstance (props, null); 
Store store = session.getStore ("pop3"); 
Store.connect(host, username, password); 
Folder folder = store.getFolder ("INBOX"); 
folder.open(Folder.READ ONLY); 
Message message[] = folder.getMessages(); 
System.out.println("Messages's length: " + message.length); 
ReceiveMail pmm = null; 
for (int i = 0; i « message.length; i++) { 
pmm = new ReceiveMail((MimeMessage) message[il); 
System.out 
-println ("Message " + i + " subject: " + pmm.getSubject ()) ; 
System.out.println("Message " + i + " sentdate: " 
+ pmm.getSentDate ()); 
System.out.println("Message " + i+ " replysign: " 
+ pmm.getReplySign()); 
System.out.println ("Message " + i + " hasRead: " + pmm.isNew()); 
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System.out.println("Message " + i+ " containAttachment: " 

+ pmm.isContainAttach((Part) message[i])); 
System.out.println("Message " + i+ " form: " + pmm.getFrom()); 
System.out.println("Message "+ i+" to: " 

+ pmm.getMailAddress ("to") ); 
System.out.println("Message " + i+ "cc: " 

+ pmm.getMailAddress ("cc") ); 
System.out.println("Message " + i + " bcc: " 

+ pmm.getMailAddress ("bcc") ); 
pmm.setDateFormat ("yy 年 MM 月 dd 日 HH:mm") ; 
System.out.println("Message " + i + " sentdate: " 

+ pmm.getSentDate()); 

System.out.println("Message " + i + " Message-ID: " 

* pmm.getMessageId()); 
pmm.getMailContent((Part) message[il); 
System.out.println("Message " + i + " bodycontent: /r/n" 

+ pmm.getBodyText ()); 
pmm.setAttachPath("c://tmp//coffeecatl124"); 
pmm.saveAttachMent ( (Part) message[i]); 


10.3.3 Android 中 用 commons-emailjar 和 mailjar 收 发 邮件 


(1) 在 Android 中 可 以 使 用 commons-mail.jar 发 送 邮 件 ， 例 如 下 面 的 代码 : 


import org.apache.commons.net.smtp.SMTP; 

import org.apache.commons.net.smtp.SMTPClient; 

import org.apache.commons.net.smtp.SMTPReply; 
SMTPClient client - new SMTPClient( ); 

client.connect ("www.discursive.com"); 

int response - client.getReplyCode( ); 

if( SMTPReply.isPositiveCompletion( response ) ) ( 

// Set the sender and the recipients 

client.setSender( "tobrien@discursive.com" ); 
client.addRecipient( "president@whitehouse.gov" ); 
client.addRecipient( "vicepresident@whitehouse.gov" ); 
// Supply the message via a Writer 

Writer message = client.sendMessageData( ); 
message.write( "Spend more money on energy research. Thanks." ); 
message.close( ); 

// Send the message and print a confirmation 

boolean success - client.completePendingCommand( ); 
if( success ) ( 

System.out.println( "Message sent" ); 

) 

Feen 

System.out.println( "Error communicating with SMTP server" ); 
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client.disconnect( ); 


RA 注意 ; 在 Android 中 很 容易 出 错 ， 建 议 编写 如 下 异常 处 理 代码 : 


Multipart multipart = null; 
Object obj = message.getContent () 7 
if (obj instanceof Multipart) { 
multipart = (Multipart) obj; 
} else { 
this.sendJavascript ("javascript:alert ("AHAB Bale ') v) ; 
continue; 
) 


(2) 在 Android 中 可 以 使 用 mailjar 接收 邮件 ， 例 如 下 面 的 代码 : 


import org.apache.commons.io.CopyUtils; 

import org.apache.commons.io.IOUtils; 

import org.apache. commons.net.pop3.POP3Client; 

import org.apache.commons.net.pop3.POP3MessageInfo; 

POP3Client client - new POP3Client( ); 

client.connect ("www.discursive.com"); 
client.login("tobrien@discursive.com", "secretpassword"); 
POP3MessageInfo[] messages - client.listMessages( ); 

for (int i = 0; i < messages.length; i++) ( 

int messageNum - messages[i].number; 

System.out.println( "************* Message number: " + messageNum ); 
Reader reader - client.retrieveMessage( messageNum ); 
System.out.println( "Message:\n" + IOUtils.toString( reader ) ); 
IOUtils.closeQuietly( reader ); 

) 

client.logout( ); 

client.disconnect( ); 
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在 移动 手机 应 用 中 ， 多 媒体 是 一 个 重要 的 应 用 领域 。 从 严 
格 意义 上 来 讲 ， 多 媒体 包含 了 屏保 、 图 片 、 音 频 、 视 频 和 相机 
等 应 用 。 如 果 将 多 媒体 和 网 络 相 结合 ， 则 能 给 用 户 带 来 更 加 绚 
丽 的 体验 。 本 章 将 详细 介绍 Android 系统 中 开发 一 个 网 络 多 媒 
体 应 用 的 基本 知识 。 
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11.1 MediaPlayer 视频 技术 详解 


在 Android 系统 中 ， 通 常 使 用 MediaPlayer 接口 实现 音频 和 视频 的 播放 功能 。 本 节 将 
简要 介绍 MediaPlayer 接口 的 基本 知识 ， 为 读者 步 入 本 书后 面 知 识 的 学 习 打 下 基础 。 


11.1.1 MediaPlayer 基 础 


MediaPlayer 的 功能 比较 强大 ， 既 可 以 播放 音频 ， 也 可 以 播放 视频 ， 另 外 还 可 以 通过 
VideoView 来 播放 视频 ， 虽 然 VideoView 比 MediaPlayer 简单 易 用 ， 但 定制 性 不 如 用 
MediaPlayer， 要 视 情 况 进行 选用 。MediaPlayer 播放 音频 比较 简单 ， 但 是 要 播放 视频 就 需 
要 SurfaceView。 SurfaceView 比 普通 的 自 定义 View 更 有 绘图 上 的 优势 ， 它 支持 完全 的 
OpenGL ES 库 。 

MediaPlayer 能 被 用 来 控制 音频 /视频 文件 或 流 媒体 的 回放 ， 可 以 在 VideoView 中 找到 
关于 如 何 使 用 该 类 中 的 方法 的 例子 。 使 用 MediaPlayer 实现 音 /视频 播放 的 基本 步骤 如 下 。 

(1) 生成 MediaPlayer 对 象 ， 根 据 播放 文件 从 不 同 的 地 方 使 用 不 同 的 生成 方式 (参考 
MediaPlayer API 即 可 )。 

(2) 得 到 MediaPlayer 对 象 后 ， 根 据 实 际 需 要 调用 不 同 的 方法 ， 如 start), storp(). 
pause()、release() 等 。 

需要 注意 的 是 ， 在 不 需要 播放 的 时 候 要 及 时 释放 掉 与 MediaPlayer 对 象 相连 接 的 播放 
文件 ， 因 为 直接 使 用 MediaPlayer 对 象 一 般 都 是 进行 音频 播放 。 


11.1.2 ”MediaPlayer 的 状态 


图 11-1 显示 了 一 个 MediaPlayer 对 象 被 支持 的 播放 控制 操作 驱动 的 生命 周期 和 状态 。 
其 中 ， 椭 圆 代表 MediaPlayer 对 象 可 能 驻 留 的 状态 ， 弧 线 表 示 驱 动 MediaPlayer 在 各 个 状态 
之 间 迁 移 的 播放 控制 操作 。 这 里 有 两 种 类 型 的 弧 线 : 由 一 个 箭头 开始 的 弧 代 表 同 步 方法 调 
用 ; 而 以 双 箭 头 开 始 的 弧 线 代表 异步 方法 调用 。 

通过 图 11-1 可 以 知道 一 个 MediaPlayer 对 象 有 以 下 几 种 状态 。 

(1) 当 一 个 MediaPlayer 对 象 刚刚 被 用 new 操作 符 创建 或 是 调用 了 reset() 方 法 后 ， 它 就 
处 于 Idle 状态 。 当 调用 了 release0 方 法 后 ， 它 就 处 于 End 状态 。 这 两 种 状态 之 间 是 
MediaPlayer 对 象 的 生命 周期 。 

在 一 个 新 构建 的 MediaPlayer 对 象 和 一 个 调用 了 reset() 方 法 的 MediaPlayer 对 象 之 间 有 
一 个 微小 的 但 是 十 分 重要 的 差别 。 在 处 于 Idle 状态 时 ， 调 用 getCurrentPosition() ~ 
getDuration(), getVideoHeight()、 getVideoWidih(), setAudioStreamType(int), ‘seéLooping{boolean). 
setVolume(float, float), pause(). start(). stop(). seekTo(int), prepare() 或 者 prepareAsync() 
方法 都 是 编程 错误 。 当 一 个 MediaPlayer 对 象 刚 被 构建 的 时 候 ， 内 部 的 播放 引擎 和 对 象 的 
状态 都 没有 改变 ， 在 这 个 时 候 调 用 以 上 的 方法 ， 框 架 将 无 法 回调 客户 端 程序 注册 的 
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OnErrorListener.onError() 方 法 ;但 若 这 个 MediaPlayer 对 象 调 用 了 reset() 方 法 之 后 ， 再 调用 
以 上 的 方法 ， 内 部 的 播放 引擎 就 会 回调 客户 端 程序 注册 的 OnErrorListener.onError() 77 1: 


了 ， 并 将 错误 状态 传 入 。 
release0 
setDataSource() = 


prepareAsync() 


OnPreparedListener onPrepared() prepareü 


Looping = true && 
playback completes 


|. seekToO/pause() 


Looping — false && 
onCompletion() invoked on 
OnCompletionListener 


stop) 


11-1 MediaPlayerxj 


笔者 在 此 建议 ， 一 旦 一 个 MediaPlayer 对 象 不 再 被 使 用 ， 应 立即 调用 release() 方 法 来 释 
放 在 内 部 的 播放 引擎 中 与 这 个 MediaPlayer 对 象 关联 的 资源 。 资 源 可 能 包括 如 硬件 加 速 组 
件 的 单 态 组 件 ， 若 没有 调用 release( 方 法 可 能 会 导致 之 后 的 MediaPlayer 对 象 实例 无 法 使 用 
这 种 单 态 硬件 资源 ， 从 而 退回 到 软件 实现 或 运行 失败 。 一 旦 MediaPlayer 对 象 进 入 了 End 
状态 ， 它 不 能 再 被 使 用 ， 也 没有 办 法 再 迁移 到 其 他 状态 。 

此 外 ， 在 使 用 new 操作 符 创 建 的 MediaPlayer 对 象 处 于 Idle 状态 时 ， 而 那些 通过 重 
的 create() 方 法 创建 的 MediaPlayer 对 象 却 并 非 处 于 Idle KA. EKE, MRA TH 
载 的 create0 方 法 ， 那 么 这 些 对 象 已 经 是 Prepare 状态 了 。 


ial E: 
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(2) 在 一 般 情 况 下 ， 由 于 种 种 原因 一 些 播放 控制 操作 可 能 会 失败 ， 如 不 支持 的 音频 / 视 
频 格 式 、 缺 少 隔行 扫描 的 音频 /视频 、 分 辨 率 太 高 、 流 超时 等 原因 ， 等 等 。 因 此 ， 错 误 报 告 
和 恢复 在 这 种 情况 下 是 非常 重要 的 。 有 时 ， 由 于 编程 错误 ， 在 处 于 无 效 状 态 的 情况 下 可 能 
发 生 了 调用 一 个 播放 控制 操作 。 在 所 有 这 些 错误 条 件 下 ， 内 部 的 播放 引擎 会 调用 一 个 由 客 
户 端 程序 提供 的 OnErrorListener.onError() 方 法 。 客 户 端 程序 可 以 通过 调用 MediaPlayer. 
setOnErrorListener(android.media.MediaPlayer.OnErrorListener) 方 法 来 注册 OnErrorListener。 

如 果 一 旦 发 生 错误 ，MediaPlayer 对 象 会 进入 Error 状态 。 为 了 重用 一 个 处 于 Error 状 
态 的 MediaPlayer 对 象 ， 可 以 调用 reset( 方 法 把 这 个 对 象 恢复 成 Idle 状态 。 注 册 一 个 
OnErrorListener 来 获知 内 部 播放 引擎 发 生 的 错误 是 一 个 良好 的 编程 习惯 。 在 不 合法 的 状态 下 
调用 一 些 方法 ， 如 prepare()、prepareAsync() 和 setDataSource() $ji IllegalStateException 

(3) 调用 setDataSource(FileDescriptor)、setDataSource(String)、setDataSource(Context, 
Uri) 或 setDataSource(FileDescriptor,long,long) 方 法 会 使 处 于 Idle 状态 的 对 象 迁移 到 
Initialized 状态 。 

若 此 时 MediaPlayer 处 于 其 他 的 状态 ， 调 用 setDataSource() 7j i & WU HH 
IllegalStateException 异常 。 好 的 编程 习惯 是 不 要 玻 包 了 在 调用 setDataSource() 方 法 的 时 候 
可 能 会 抛 出 TllegalArgumentException 异常 和 IOException 异常 。 

(4) 在 开始 播放 之 前 ，MediaPlayer 对 象 必须 要 进入 Prepared 状态 。 

有 以 下 两 种 方法 (同步 和 异步 ) 可 以 使 MediaPlayer 对 象 进 入 Prepared 状态 。 

Q prepare 7 ik (IH) 25): 调用 该 方法 返回 则 表示 MediaPlayer 对 象 已 经 进入 了 

Prepared 状态 。 
口 ”prepareAsync() 方 法 (异步 ): 调用 该 方法 会 使 此 MediaPlayer 对 象 进入 Preparing 状 
态 并 返回 ， 而 内 部 的 播放 引擎 会 继续 未 完成 的 准备 工作 。 

当 同 步 版 本 返回 时 或 异步 版 本 的 准备 工作 完全 完成 时 就 会 调用 客户 端 程序 提供 的 
OnPreparedListener.onPrepared() 监听 方法 。 可 以 调用 MediaPlayer.setOnPreparedListener 
(android.media.MediaPlayer.OnPreparedListener) 方 法 来 注册 OnPreparedListener。 

Preparing 是 一 个 中 间 状 态 ， 在 此 状态 下 调用 任何 有 影响 的 方法 的 结果 都 是 未 知 的。 在 
不 合适 的 状态 下 调用 prepare fl prepareAsync() 方 法 会 抛 出 IllegalStateException 异常 。 当 
MediaPlayer 对 象 处 于 Prepared 状态 时 ， 可 以 调整 音频 /视频 的 属性 ， 如 音量 、 播 放 时 是 否 
一 直 亮 屏 、 循 环 播放 等 。 

(5) 在 要 开始 播放 时 必须 调用 start0 方 法 。 当 此 方法 成 功 返 回 时 ，MediaPlayer 对 象 处 
于 Started 状态 。isPlaying() 方 法 可 以 被 调用 用 来 测试 某 个 MediaPlayer 对 象 是 否 处 于 Started 

当 处 于 Started 状态 时 ， 内 部 播放 引擎 会 调用 客户 端 程序 提供 的 
OnBufferingUpdateListener.onBufferingUpdate() 回 调 方法 ， 此 回调 方法 允许 应 用 程序 追踪 流 
播放 的 缓冲 状态 。 对 一 个 已 经 处 于 Started 状态 的 MediaPlayer 对 象 调用 start0 方 法 是 没有 
影响 的 。 

(6) 播放 可 以 被 暂停 、 停 止 以 及 调整 当前 播放 位 置 。 当 调用 pause() 方 法 并 返回 时 ， 会 
使 MediaPlayer 对 象 进入 Paused 状态 。 注 意 Started 与 Paused 状态 的 相互 转换 在 内 部 的 播 
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放 引 擎 中 是 异步 的 。 所 以 可 能 需要 一 点 时 间 在 isPlaying0 方 法 中 更 新 状态 ， 若 在 播放 流 内 
容 ， 这 段 时 间 可 能 会 有 几 秒 。 

调用 start() 方 法 会 让 一 个 处 于 Paused 状态 的 MediaPlayer 对 象 从 之 前 暂停 的 地 方 恢复 
播放 。 当 调用 start() 方 法 返回 的 时 候 ，MediaPlayer 对 象 的 状态 又 会 变 成 Started 状态 。 对 一 
个 已 经 处 于 Paused 状态 的 MediaPlayer 对 象 ，pause() 方 法 没有 影响 。 

(7) 调用 stop0 方 法 会 停止 播放 ， 并 且 还 会 让 一 个 处 于 Started, Paused, Prepared 或 
PlaybackCompleted 状态 的 MediaPlayer 进入 Stopped 状态 。 对 一 个 已 经 处 于 Stopped 状态 
的 MediaPlayer 对 象 ，stop() 方 法 没有 影响 。 

(8) 调用 seekTo0 方 法 可 以 调整 播放 的 位 置 。 方 法 seekTo(inb 是 异步 执行 的 ， 所 以 它 可 
以 马上 返回 ， 但 是 实际 的 定位 播放 操作 可 能 需要 一 段 时 间 才 能 完成 ， 尤 其 是 播放 流 形式 的 
音频 /视频 。 当 实际 的 定位 播放 操作 完成 之 后 ， 内 部 的 播放 引擎 会 调用 客户 端 程序 提供 的 
OnSeekComplete.onSeekComplete() 回 调 方法 。 可 以 通过 调用 方法 setOnSeekCompleteListener 
(OnSeekCompleteListener) 注 册 。 

在 此 需要 注意 ，seekTo(int) 方 法 也 可 以 在 其 他 状态 下 调用 ， 比 如 Prepared, Paused 或 
PlaybackCompleted 状态 。 此 外 ， 目 前 的 播放 位 置 ， 实 际 可 以 通过 调用 getCurrentPosition() 
方法 得 到 ， 它 可 以 帮助 如 音乐 播放 器 的 应 用 程序 不 断 更 新 播放 进度 。 

(9) 当 播 放 到 流 的 末尾 时 完成 播放 。 如 果 调 用 了 setLooping(boolean) 方 法 开启 了 循环 模 
式 ， 那 么 MediaPlayer 对 象 会 重新 进入 Started 状态 。 如 果 没 有 开启 循环 模式 ， 那 么 内 部 的 
播放 引擎 会 调用 客户 端 程序 提供 的 OnCompletion.onCompletion() 回 调 方法 。 可 以 通过 调用 
MediaPlayer.setOnCompletionListener(OnCompletionListener) 方 法 来 设置 。 内 部 的 播放 引擎 

- 旦 调用 了 OnCompletion.onCompletion0 回 调 方法 ， 说 明 这 个 MediaPlayer 对 象 进入 了 
PlaybackCompleted 状态 。 当 处 于 PlaybackCompleted 状态 的 时 候 ， 可 以 调用 start0 方 法 来 
让 这 个 MediaPlayer 对 象 再 进入 Started 状态 。 


11.1.3 ”MediaPlayer 方 法 的 有 效 状态 和 无 效 状态 


MediaPlayer 方法 的 有 效 状态 和 无 效 状 态 如 下 。 

Q getCurentPosition (Idle, Initialized, Prepared, Started, Paused, Stopped, PlaybackCompleted} 
{Error}: 在 有 效 状态 成 功 调用 该 方法 不 会 改变 此 时 的 状态 ， 在 无 效 状态 调用 该 方 
法 则 会 使 该 状态 转换 到 错误 状态 中 。 

Q getDuration (Prepared, Started, Paused, Stopped, PlaybackCompleted} (Idle, Initialized, 
Error}: 在 有 效 状 态 中 成 功 调用 该 方法 不 会 改变 此 时 的 状态 ， 在 无 效 状 态 调用 该 
方法 则 会 使 该 状态 转换 到 错误 状态 中 。 

ū  getVideoHeight (Idle, Initialized, Prepared, Started, Paused, Stopped, PlaybackCompleted} 
{Error}: 在 有 效 状 态 成 功 调用 该 方法 不 会 改变 此 时 的 状态 ， 在 无 效 状态 调用 该 方 
法 则 会 使 该 状态 转换 到 错误 状态 中 。 

Q getVideoWidth (Idle, Initialized, Prepared, Started, Paused, Stopped, PlaybackCompleted} 
{Error}: 在 有 效 状态 成 功 调用 该 方法 不 会 改变 此 时 的 状态 ， 在 无 效 状态 调用 该 方 
法 则 会 使 该 状态 转换 到 错误 状态 中 。 
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OQ isPlaying (Idle, Initialized, Prepared, Started, Paused, Stopped, PlaybackCompleted} 
{Error}: 在 有 效 状 态 成 功 调用 该 方法 不 会 改变 此 时 的 状态 ， 在 无 效 状态 调用 该 方 
法 则 会 使 该 状态 转换 到 错误 状态 中 。 

ū pause {Started, Paused} {Idle, Initialized, Prepared, Stopped, PlaybackCompleted, 
Error}: 在 有 效 状 态 成 功 调用 该 方法 则 改变 此 时 的 状态 到 暂停 状态 ， 在 无 效 状态 
调用 该 方法 则 会 使 该 状态 转换 到 错误 状态 中 。 

Q prepare {Initialized, Stopped} (Idle, Prepared, Started, Paused, PlaybackCompleted, 
Eror): 在 有 效 状 态 成 功 调用 该 方法 则 改变 此 时 的 状态 到 准备 状态 ， 在 无 效 状 态 
调用 该 方法 则 会 抛 出 错误 状态 异常 。 

ū  prepareAsync {Initialized, Stopped} (Idle, Prepared, Started, Paused, PlaybackCompleted, 
Error}: 在 有 效 状态 成 功 调用 该 方法 则 改变 此 时 的 状态 到 准备 状态 ， 在 无 效 状态 
调用 该 方法 则 会 抛 出 错误 状态 异常 。 

Q release any (): 在 release() 该 对 象 不 再 是 可 用 的 。 

Q reset (Idle, Initialized, Prepared, Started, Paused, Stopped, PlaybackCompleted, Error} 
HQ: 在 reset0 后 该 对 象 如 刚 创 建 的 一 样 。 

Q seekTo (Prepared, Started, Paused, PlaybackCompleted} {Idle, Initialized, Stopped, 
Error}: 在 有 效 状态 成 功 调用 该 方法 改变 此 时 的 状态 到 暂停 状态 ， 在 无 效 状态 调 
用 该 方法 则 会 使 该 状态 转换 到 错误 状态 中 。 

Q  setAudioStreamType (Idle, Initialized, Stopped, Prepared, Started, Paused, PlaybackCompleted} 
{Error} 在 有 效 状 态 成 功 调用 该 方法 改变 此 时 的 状态 到 暂停 状态 。 

Q setDataSource {Idle} (Initialized, Prepared, Started, Paused, Stopped, PlaybackCompleted, 
Error}: 在 有 效 状态 成 功 调用 该 方法 改变 此 时 的 状态 到 初始 化 状态 ， 在 无 效 状态 
调用 该 方法 则 会 抛 出 错误 状态 异常 。 

口 setDisplay any {}: 在 任何 状态 都 可 以 调用 该 方法 且 不 会 改变 当前 对 象 的 状态 。 

Q setLooping (Idle, Initialized, Stopped, Prepared, Started, Paused, PlaybackCompleted} 
{Error}: 在 有 效 状 态 成 功 调用 该 方法 不 会 改变 此 时 的 状态 ， 在 无 效 状态 调用 该 方 
法 则 会 使 该 状态 转换 到 错误 状态 中 。 


口 isLooping any (): 在 任何 状态 都 可 以 调用 该 方法 且 不 会 改变 当前 对 象 的 状态 。 

Q  setOnBufferingUpdateListener any{}: 在 任何 状态 都 可 以 调用 该 方法 且 不 会 改变 当 
前 对 象 的 状态 。 

Q  setOnCompletionListener any{}: 在 任何 状态 都 可 以 调用 该 方法 且 不 会 改变 当前 对 

Q setOnErrorListener any{}: 在 任何 状态 都 可 以 调用 该 方法 且 不 会 改变 当前 对 象 的 

Q  setOnPreparedListener any{}: 在 任何 状态 都 可 以 调用 该 方法 且 不 会 改变 当前 对 象 
的 状态 。 

QU  setOnSeekCompleteListener any{}: 在 任何 状态 都 可 以 调用 该 方法 且 不 会 改变 当前 
对 象 的 状态 。 


Q  setScreenOnWhilePlaying any(): 在 任何 状态 都 可 以 调用 该 方法 且 不 会 改变 当前 对 
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setVolume (Idle, Initialized, Stopped, Prepared, Started, Paused, PlaybackCompleted} 
{Error}: 成 功 调用 该 方法 不 会 改变 当前 的 状态 。 

setWakeMode any{}: 在 任何 状态 都 可 以 调用 该 方法 且 不 会 改变 当前 对 象 的 状态 。 
start (Prepared, Started, Paused, PlaybackCompleted} (Idle, Initialized, Stopped, Error}: 
在 有 效 状 态 成 功 调用 该 方法 改变 此 时 的 状态 到 开始 状态 ， 在 无 效 状 态 调用 该 方法 
则 会 转换 到 错误 状态 。 

stop (Prepared, Started, Stopped, Paused, PlaybackCompleted} {Idle, Initialized, Error}: 
在 有 效 状 态 成 功 调用 该 方法 改变 此 时 的 状态 到 停止 状态 ， 在 无 效 状 态 调用 该 方法 
则 会 转换 到 错误 状态 。 


11.1.4 MediaPlayer 的 接口 


MediaPlayer 的 接口 如 下 。 


a 


a 


a 


MediaPlayer.OnBufferingUpdateListener: 该 接口 定义 了 调用 指明 网 络 上 的 媒体 资 
源 以 缓冲 流 的 形式 播放 。 

MediaPlayer.OnCompletionListener: 该 接口 是 为 当 媒体 资源 的 播放 完成 后 被 调用 
的 回放 定义 的 。 

MediaPlayer.OnErrorListener: 该 接口 定义 了 当 在 异步 操作 时 (其 他 错误 将 会 在 呼叫 
方法 的 时 候 抛 出 异常 ) 出 现 错误 后 调用 的 回放 操作 。 

MediaPlayer.OnInfoListener: 该 接口 定义 了 与 一 些 关 于 媒体 或 它 的 播放 的 信息 以 
及 /或 者 警告 相关 的 被 调用 的 回放 。 

MediaPlayer.OnPreparedListener: 该 接口 是 为 媒体 的 资源 准备 播放 的 时 候 调 用 回 
放 定义 的 。 

MediaPlayer.OnSeekCompleteListener: 该 接口 定义 了 指明 查找 操作 完成 后 调用 的 
回放 操作 。 

MediaPlayer.OnVideoSizeChangedListener: 该 接口 定义 了 当 视 频 大 小 被 首次 知晓 
或 更 新 的 时 候 调用 的 回放 。 


11.1.5 MediaPlayer&S 35 & 


MediaPlayer 的 常量 如 下 。 


口 


口 
口 


int MEDIA ERROR NOT VALID FOR PROGRESSIVE PLAYBACK: 视频 流 及 
其 容器 不 支持 连续 的 、 非 处 于 播放 文件 内 的 播放 视频 序列 。 

int MEDIA ERROR SERVER DIED: 媒体 服务 终止 。 

int MEDIA ERROR UNKNOWN: 未 指明 的 媒体 播放 错误 。 

int MEDIA INFO BAD INTERLEAVING: 不 正确 的 交叉 存储 技术 意味 着 媒体 被 
不 适当 地 交叉 存储 或 者 根本 就 没有 交叉 存储 。 

int MEDIA INFO METADATA UPDATE: 一 套 新 的 可 用 的 元 数据 。 

int MEDIA INFO NOT SEEKABLE: 媒体 位 置 不 可 查找 。 


口 
口 
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int MEDIA INFO UNKNOWN: 未 指明 的 媒体 播放 信息 。 
int MEDIA INFO VIDEO TRACK LAGGING: 视频 对 于 解码 器 太 复杂 ， 以 至 于 
不 能 解码 足够 快 的 帧 率 。 


11.1.6 ”MediaPlayer 的 公共 方法 


MediaPlayer 的 公共 方法 如 下 。 


口 


口 
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static MediaPlayer create(Context context, Uri uri): 指定 从 URI 对 应 的 资源 文件 中 
来 装载 音乐 文件 ， 并 返回 MediaPlyaer 对 象 。 

static MediaPlayer create(Context context int resid): 指定 从 资源 ID 对 应 的 资源 文 
件 中 来 装载 音乐 文件 ， 并 返回 MediaPlyaer 对 象 。 

static MediaPlayer create(Context context, Uri uri, SurfaceHolder holder): 指定 从 资 
源 ID 对 应 的 资源 文件 中 来 装载 音乐 文件 ， 同 时 指定 了 SurfaceHolder 对 象 并 返回 
MediaPlyaer Xj $$. 

int getCurrentPosition(): 获得 当前 播放 的 位 置 。 

int getDuration(): 获得 文件 段 。 

int getVideoHeight(): 获得 视频 的 高 度 。 

int getVideoWidth(): 获得 视频 的 宽度 。 

boolean isLooping(): 检查 MedioPlayer 处 于 循环 与 否 。 

boolean isPlaying(): 检查 MedioPlayer 是 否 在 播放 。 

void pause(): 暂停 播放 。 

void prepare(): 让 播放 器 处 于 准备 状态 (同步 的 )。 

void prepareAsync(): 让 播放 器 处 于 准备 状态 (异步 的 )。 

void release(): 释放 与 MediaPlayer 相关 的 资源 。 

void reset(): 重 置 MediaPlayer 到 初始 化 状态 。 

void seekTo(int msec): 搜寻 指定 的 时 间 位 置 。 

void setAudioStreamType(int streamtype): 为 MediaPlayer 设 定 音 频 流 类 型 。 

void setDataSource(String path): 设 定 使 用 的 数据 源 ( 文 件 路 径 或 http/rtsp 地 址 )。 
void setDataSource(FileDescriptor fd, long offset, long length): 设 定 使 用 的 数据 源 
(filedescriptor). 

void setDataSource(FileDescriptor fd): 设 定 使 用 的 数据 源 (filedescriptor)。 

void setDataSource(Context context, Uri uri): 设 定 一 个 如 URI 内容 的 数据 源 。 

void setDisplay(SurfaceHolder sh): 设 定 播放 该 Video 的 媒体 播放 器 的 
SurfaceHolder. 

void setLooping(boolean looping): 设 定 播放 器 循环 或 是 不 循环 。 

void setOnBufferingUpdateListener(MediaPlayer.OnBufferingUpdateListener listener): 
注册 一 个 当 网 络 缓冲 数据 流 变 化 的 时 候 调 用 的 播放 事件 。 

void setOnCompletionListener(MediaPlayer.OnCompletionListener listener): 注册 一 
个 当 媒 体 资源 在 播放 的 时 候 到 达 终点 时 调用 的 播放 事件 。 
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void setOnErrorListener(MediaPlayer.OnErrorListener listener): 注册 一 个 当 在 异步 
操作 过 程 中 发 生 错误 的 时 候 调 用 的 播放 事件 。 
void setOnInfoListener(MediaPlayer.OnInfoListener listener): 注册 一 个 当 有 信息 / 警 
告 出 现 的 时 候 调 用 的 播放 事件 。 
void setOnPreparedListener(MediaPlayer.OnPreparedListener listener): 注册 一 个 当 
媒体 资源 准备 播放 的 时 候 调用 的 播放 事件 。 
void setOnSeekCompleteListener(MediaPlayer.OnSeekCompleteListener listener): 注 
册 一 个 当 搜寻 操作 完成 后 调用 的 播放 事件 。 
void setOnVideoSizeChangedL istener(MediaPlayer.OnVideoSizeChangedL istener listener): 
注册 一 个 当 视 频 大 小 知晓 或 更 新 后 调用 的 播放 事件 。 
void setScreenOnWhilePlaying(boolean screenOn): 控制 当 视频 播放 发 生 时 是 否 使 
用 SurfaceHolder 来 保持 屏幕 。 
void setVolume(float leftVolume, float rightVolume): 设置 播放 器 的 音量 。 
void setWakeMode(Context context, int mode): 为 MediaPlayer 设置 低 等 级 的 电源 
管理 状态 。 
void start): 开始 或 恢复 播放 。 
void stop(): 停止 播放 。 


11.2 VideoView 技术 详解 


VideoView 的 用 法 和 其 他 Widget 私 用 方法 类 似 ， 在 使 用 时 必须 先 在 Layout XML 中 定 
X. VideoView 属性 ， 然 后 在 程序 中 通过 findViewById(0) 方 法 即 可 创建 VideoView 对 象 。 
VideoView 的 最 大 用 处 是 播放 视频 文件 。VideoView 类 可 以 从 不 同 的 来 源 (例如 资源 文件 或 
内 容 提供 器 ) 读 取 图 像 ， 计 算 和 维护 视频 的 画面 尺寸 以 使 其 适用 于 任何 布局 管理 器 ， 并 提 
供 一 些 诸如 缩放 、 着 色 之 类 的 显示 选项 。 本 节 将 简要 介绍 VideoView 技术 的 基本 知识 。 


11.2:1 


Vid 
其 中 


VideoView 的 构造 函数 


eoView 有 三 个 构造 函数 。 
P 第 一 个 构造 函数 的 语法 格式 如 下 : 


public VideoView (Context context) 

通过 上 述 函 数 可 以 创建 一 个 默认 属性 的 VideoView Hi], BR context 表示 视图 运行 
的 应 用 程序 上 下 文 ， 通 过 它 可 以 访问 当前 的 主题 、 资 源 ， 等 等 。 

第 二 个 构造 函数 的 语法 格式 如 下 : 

public VideoView (Context context, AttributeSet attrs) 


通过 上 述 函 数 可 以 创建 一 个 带 有 attrs 属性 的 VideoView 实例 ， 其 中 参数 的 具体 说 明 如 下 。 


口 


Context: 表示 视图 运行 的 应 用 程序 上 下 文 ， 通 过 它 可 以 访问 当前 主题 、 资 源 ， 
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Q atts: 用 于 视图 的 XML 标签 属性 集合 。 
第 三 个 构造 函数 的 语法 格式 如 下 : 
public VideoView (Context context, AttributeSet attrs, int defStyle) 


通过 上 述 函数 可 以 创建 一 个 带 有 attrs 属性 ， 并 且 指定 其 默认 样式 的 VideoView 实例 。 
参数 的 具体 说 明 如 下 。 
O context: 视图 运行 的 应 用 程序 上 下 文 ， 通 过 它 可 以 访问 当前 主题 、 资 源 ， 等 等 。 
Q atts: 用 于 视图 的 XML 标签 属性 集合 。 
O defStyle: 应 用 到 视图 的 默认 风格 。 如 果 为 0， 则 不 应 用 风格 (包括 当前 主题 中 
的 )。 该 值 可 以 是 当前 主题 中 的 属性 资源 ， 或 者 是 明确 的 风格 资源 ID. 


11.2.2 VideoView 的 公共 方法 


VideoView 中 公共 方法 的 具体 说 明 如 下 。 

(1) public boolean canPause (): 判断 是 否 能 够 暂停 播放 视频 。 

(2) public boolean canSeekBackward (): 判断 是 否 能 够 倒退 。 

(3) public boolean canSeekForward 0: 判断 是 否 能 够 快 进 。 

(4) public int getBufferPercentage (): 获得 缓冲 区 的 百分比 。 

(5) public int getCurrentPosition (): 获得 当前 的 位 置 。 

(6) public int getDuration (): 获得 所 播放 视频 的 总 时 间 。 

(7) public boolean isPlaying 0: 判断 是 否 正在 播放 视频 。 

(8) public boolean onKeyDown (int keyCode, KeyEvent event): 是 KeyEvent.Callback. 
onKeyMultiple() 的 默认 实现 。 如 果 视 图 可 用 并 可 按 ， 当 按 下 KEYCODE DPAD CENTER 
或 KEYCODE_ENTER 时 执行 视图 的 按 下 事件 。 

此 函数 参数 的 具体 说 明 如 下 。 

Q keyCode: 表示 按 下 的 键 的 、 在 KEYCODE ENTER 中 定义 的 键盘 代码 。 

QU event: KeyEvent 对 象 ， 定 义 了 按钮 动作 。 

如 果 处 理 了 事件 则 返回 tue。 如 果 人 允许 下 一 个 事件 接收 器 处 理 该 事件 ， 则 返回 false. 

(9) public boolean onTouchEvent (MotionEvent ev): 通过 该 方法 来 处 理 触 屏 事 件 。 参 数 
event 表示 触 屏 事 件 。 如 果 事 件 已 经 处 理 返回 tue， 和 否则 返回 false. 

(10) public boolean onTrackballEvent (MotionEvent ev): 利用 该 方法 去 处 理 轨迹 球 的 动 
作 事 件 ， 轨 迹 球 相对 于 上 次 事件 移动 的 位 置 能 用 MotionEvent.getX() 和 MotionEvent.getY() 
函数 取 回 。 对 应 用 户 按 下 一 次 方向 键 ， 它 们 通常 作为 一 次 移动 处 理 ( 为 了 表现 来 自 轨迹 球 的 
更 小 粒度 的 移动 信息 ， 它 们 返回 小 数 )。 参 数 ev 表示 动作 的 事件 。 

(11) public void pause 0: 使 得 播放 暂停 。 

(12) public int resolveAdjustedSize(int desiredSize, int measureSpec): 取得 调整 后 的 尺 
SFe WIR measureSpec 对 象 传 入 的 模式 是 UNSPECIFIED， 那 么 返回 的 是 desiredSize。 如 果 
measureSpec 对 象 传 入 的 模式 是 AT. MOST， 返 回 的 将 是 desiredSize 和 measureSpec 对 象 的 
尺寸 两 者 中 最 小 的 那个 。 如 果 measureSpec 对 象 传 入 的 模式 是 EXACTLY， 那 么 返回 的 是 
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measureSpec 对 象 中 的 尺寸 大 小 值 。 
34 注意 : MeasureSpec 是 一 个 android.view.View 内 部 类 。 它 封装 了 从 父 类 传送 到 子 类 
的 布局 要 求 信 息 。 每 个 MeasureSpec 对 象 描述 了 控件 的 高 度 或 者 宽度 。 
MeasureSpec 对 象 是 由 尺寸 和 模式 组 成 的 ， 有 3 个 模式 : UNSPECIFIED. 
EXACTLY. AT MOST， 这 个 对 象 由 MeasureSpec makeMeasureSpec(0) 函 数 创 建 。 


(13) public void resume 0: 用 于 恢复 挂 起 的 播放 器 。 

(14) public void seekTo (int msec): 设置 播放 位 置 。 

(15) public void setMediaController (MediaController controller): 设置 媒体 控制 器 。 

(16) public void setOnCompletionListener (MediaPlayer.OnCompletionListener 1): 注册 在 
媒体 文件 播放 完毕 时 调用 的 回调 函数 。 

其 中 参数 “1” 表 示 要 执行 的 回调 函数 。 

(17) public void setOnErrorListener (MediaPlayer.OnErrorListener 1): 注册 在 设置 或 播放 
过 程 中 发 生 错误 时 调用 的 回调 函数 。 如 果 未 指定 回调 函数 或 回调 函数 返回 假 ， 则 
VideoView 会 通知 用 户 发 生 了 错误 。 其 中 参数 “1” 表 示 要 执行 的 回调 函数 。 

(18) public void setOnPreparedListener (MediaPlayer.OnPreparedListener 1): 用 于 注册 在 
媒体 文件 加 载 完 毕 ， 可 以 播放 时 调用 的 回调 函数 。 其 中 参数 “1” 表 示 要 执行 的 回调 函数 。 

(19) public void setVideoPath (String path): 用 于 设置 视频 文件 的 路 径 名 。 

(20) public void setVideoURI (Uri uri): 设置 视频 文件 的 统一 资源 标识 符 。 

(21) public void start 0: 开始 播放 视频 文件 。 

(22) public void stopPlayback 0: 停止 回放 视频 文件 。 

(23) public void suspend 0: 挂 起 视频 文件 的 播放 。 


11.3 在 Android 中 播放 网 络 上 的 MP3 


为 了 节约 手机 的 存储 空间 ， 在 听 音 乐 时 可 以 从 网 络 上 下 载 的 方式 播放 MP3 。 本 节 将 通 
过 一 个 具体 实例 的 实现 过 程 ， 来 讲解 在 Android 系统 中 播放 网 络 MP3 的 方法 。 


实 例 功 能 源码 路 径 


MP 


在 本 实例 中 ， 首 先 插入 4 个 按钮 ， 分 别 用 于 播放 、 和 暂停 、 重 新 播放 和 停止 处 理 。 执 行 
后 ， 通 过 Runnable 发 起 运行 线程 ， 在 线程 中 远程 下 载 指定 的 MP3 文件 ， 是 通过 网 络 传输 
方式 下 载 的 。 下 载 完毕 后 ， 临 时 保存 到 SD 卡 中 ， 这 样 可 以 通过 4 个 按钮 对 其 进行 控制 。 
当 程 序 关闭 后 ， 删 除 SD 卡 中 的 临时 文件 。 本 实例 的 具体 实现 流程 如 下 。 
(1) 编写 布局 文件 main xml， 在 里 面 插入 4 个 图 片 按钮 ， 主 要 代码 如 下 : 
<TextView 
android: id="@+id/myTextViewl" 


android:layout width="fill parent" 
android: layout_height="wrap_ content" 
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android: textColor="@drawable/blue" 
android: text="@string/hello" 

[= 

<LinearLayout 
android: orientation="horizontal" 
android:layout height="wrap content" 
android:layout width="fill parent” 
android: padding="10dip" 

> 

<ImageButton android:id="@+id/play" 
android:layout height="wrap content" 
android:layout width="wrap content" 
android: src="@drawable/play" 

/> 

<ImageButton android:id="@+id/pause" 
android:layout height="wrap content" 
android:layout width="wrap content" 
android: src="@drawable/pause" 

/> 

<ImageButton android: id="@+id/reset" 
android:layout height="wrap content" 
android:layout width="wrap content" 
android: src="@drawable/reset" 

/> 

<ImageButton android:id="@+id/stop" 
android: layout height-"wrap content" 
android:layout width="wrap content" 
android: src="@drawable/stop" 

/> 

</LinearLayout> 


(2) 编写 主 程序 文件 mp.java， 其 具体 实现 流程 如 下 。 
中 定义 currentFilePath 用 于 记录 当前 正在 播放 MP3 的 URL 地 址 ， 定 义 
currentTempFilePath 表示 当前 播放 MP3 的 路 径 。 具 体 代码 如 下 : 
/* 记 录 当 前 正在 播放 MP3 的 地 址 URL*/ 


private String currentFilePath = ""; 

/* 当 前 播放 MP3 的 路 径 */ 

private String currentTempFilePath = ""; 
private String strVideoURL - ""; 


Q) 使 用 strVideoURL 设置 要 播放 MP3 文件 的 网 址 ， 并 设置 透明 度 。 具 体 代码 如 下 : 


public void onCreate(Bundle savedInstanceState) 
f 
super.onCreate (savedInstanceState); 
setContentView (R.layout.main); 
/* MP3 文件 不 会 被 下 载 到 local*/ 
strVideoURL = "http://www.lrn.cn/zywh/Xyyy/yyxs/200805/ 
W020080505536315331317.mp3"; 
mTextView01 = (TextView)findViewById (R.id.myTextViewl); 
/* 设 置 透明 度 */ 
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getWindow().setFormat (PixelFormat.TRANSPARENT); 
mPlay = (ImageButton) findViewById(R.id.play) ; 
mReset = (ImageButton) findViewById(R.id.reset) ; 
mPause = (ImageButton) findViewById (R.id.pause); 
mStop = (ImageButton) findViewById (R.id.stop); 


C 编写 单 击 “ 播 放 ” 按 钮 所 触发 的 处 理事 件 ， 具 体 代码 如 下 : 
/* 播放 按钮 */ 


mPlay.setOnClickListener(new ImageButton.OnClickListener () 
{ 
public void onClick(View view) 
{ 
/* 调用 播放 影片 Function */ 
playVideo (strVideoURL); 
mTextView01.setText 
( 
getResources().getText(R.string.str play) .toString()+ 
"\n"+ strVideoURL 


© 编写 单 击 “ 重 播 ”按钮 所 触发 的 处 理事 件 ， 具 体 代码 如 下 : 
/* 重新 播放 */ 


mReset.setOnClickListener(new ImageButton.OnClickListener () 
public void onClick(View view) 
j if(bIsReleased -- false) 
i if (mMediaPlayer01 != null) 
mMediaPlayer01.seekTo (0); 
mTextView0l.setText(R.string.str play); 


O 编写 单 击 “ 和 暂停 ”按钮 所 触发 的 处 理事 件 ， 具 体 代码 如 下 : 
/* 暂停 播放 */ 


mPause.setOnClickListener(new ImageButton.OnClickListener () 
{ 
public void onClick(View view) 
{ 
if (mMediaPlayer01 != null) 
t 
if(bIsReleased == false) 


t 
if (bIsPaused--false) 
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mMediaPlayer01.pause(); 
bIsPaused = true; 
mTextView0l.setText(R.string.str pause); 
} 
else if (bIsPaused==true) 
{ 
mMediaPlayer01.start(); 
bIsPaused = false; 
mTextViewOl.setText(R.string.str play); 
} 


he 
© 编写 单 击 “ 停 止 ” 按 钮 所 触发 的 处 理事 件 ， 具 体 代码 如 下 : 
/* 停 止 */ 


mStop.setOnClickListener (new ImageButton.OnClickListener () 
{ 
public void onClick(View view) 
{ 
try 
{ 
if (mMediaPlayer0l != null) 
{ 
if (bIsReleased==false) 
{ 
mMediaPlayer01.seekTo (0) ; 
mMediaPlayer01.pause(); 
//mMediaPlayer01.stop(); 
//mMediaPlayer01.release(); 
//bIsReleased - true; 
mTextView01.setText (R.string.str stop); 
$ 
} 
b 
catch (Exception e) 
t 
mTextView01.setText (e.toString()); 
Log.e(TAG, e.toString()); 
e.printStackTrace(); 
} 
} 
be 
} 


(D 定义 方法 playVideo(final String strPath) 来 播放 指定 的 MP3， 其 播放 的 是 存储 卡 中 暂 
时 保存 的 MP3 文件 ， 具 体 代码 如 下 : 
private void playVideo(final String strPath) 


{ 
try 
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t 
if (strPath.equals(currentFilePath)&& mMediaPlayer01 != null) 
t 
mMediaPlayer0l.start(); 
return; 
} 
currentFilePath = strPath; 
mMediaPlayer01 = new MediaPlayer (); 
mMediaPlayer01.setAudioStreamType (2) ; 


(8) 编写 setOnErrorListener 来 监听 错误 处 理 ， 具 体 代 码 如 下 : 
/* 错 误 事件 */ 


mMediaPlayer01.setOnErrorListener (new MediaPlayer.OnErrorListener () 
{ 
@override 
public boolean onError (MediaPlayer mp, int what, int extra) 
{ 
//TODO Auto-generated method stub 
Log.i(TAG, "Error on Listener, what: " + what + "extra: " + extra); 
return false; 


he 


(9) 编写 setOnBufferingUpdateListener 来 监听 MediaPlayer 缓冲 区 的 更 新 ， 有 具体 代码 
如 下 : 
/* 捕捉 使 用 MediaPlayer 缓冲 区 的 更 新 事件 */ 


mMediaPlayer01.setonBufferingUpdateListener (new 
MediaPlayer .OnBufferingUpdateListener () 
{ 
@override 
public void onBufferingUpdate (MediaPlayer mp, int percent) 
{ 
//TODO Auto-generated method stub 
Log.i(TAG, "Update buffer: " + Integer.toString(percent)+ "%"); 


E 
编写 setOnCompletionListener 来 监听 播放 完毕 所 触发 的 事件 ， 有 具体 代码 如 下 : 
/* 播放 完毕 所 触发 的 事件 */ 


mMediaPlayer01.setOnCompletionListener (new 
MediaPlayer.OnCompletionListener() 
t 
GOverride 
public void onCompletion (MediaPlayer mp) 
t 
//TODO Auto-generated method stub 
//delFile (currentTempFilePath) ; 
Log.i(TAG,"mMediaPlayer01 Listener Completed"); 
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O 编写 setOnPreparedListener 来 监听 开始 阶段 的 事件 ， 具 体 代 码 如 下 : 
/* 开始 阶段 的 监听 Listener */ 


mMediaPlayer01.setOnPreparedListener (new 
MediaPlayer.OnPreparedListener() 


t 
@override 
public void onPrepared (MediaPlayer mp) 
{ 
//TODO Auto-generated method stub 
Log.i(TAG,"Prepared Listener") ; 
} 
); 


O 将 文件 存储 到 SD 卡 后 ， 通 过 方法 mMediaPlayer01.start() 播 放 MP3。 具 体 代码 如 下 : 
/* JH Runnable 来 确保 文件 在 存储 完毕 后 才 开始 start () */ 


Runnable r = new Runnable() 
t 
public void run() 
t 
try 
t 
/* setDataSource 将 文件 存 到 sD 卡 */ 
setDataSource (strPath); 
/* 因为 线程 顺利 进行 ， 所 以 在 setDataSource 后 运行 prepare () */ 
mMediaPlayer01.prepare(); 
Log.i(TAG, "Duration: " + mMediaPlayer0l.getDuration()); 


/* 开始 播放 mp3 */ 
mMediaPlayer01l.start(); 
bIsReleased - false; 
} 
catch (Exception e) 
{ 
Log.e(TAG, e.getMessage(), e); 
H 
} 
n 
new Thread(r).start(); 
H 


O 如 果 有 异常 则 输出 提示 ， 具 体 代码 如 下 : 


catch (Exception e) 


{ 
if (mMediaPlayer01 != null) 


t 
/* 线程 发 生 异 常 则 停止 播放 */ 
mMediaPlayer01.stop(); 
mMediaPlayer0l.release(); 
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e.printStackTrace(); 
) 
) 


(3 定义 函数 setDataSource 用 于 存储 URL 的 MP3 文件 到 存储 卡 。 首 先 判断 传 入 的 地 
址 是 否 为 URL， 然 后 创建 URL 对 和 象 和 临时 文件 。 具 体 代码 如 下 : 
/* ”定义 函数 用 于 存储 ORL 的 MP3 文件 到 存储 卡 — */ 


private void setDataSource(String strPath) throws Exception 
t 
/* ”判断 传 入 的 地 址 是 否 为 URL */ 
if (!URLUtil.isNetworkUrl (strPath) ) 
t 
mMediaPlayer01.setDataSource (strPath); 
) 
else 
t 
if(bIsReleased == false) 
t 
/* 创建 URL 对 象 */ 
URL myURL = new URL(strPath); 
URLConnection conn = myURL.openConnection(); 
conn.connect () ; 


/* ”获取 URLConnection 的 InputStream */ 
InputStream is = conn.getInputStream(); 
if (is == null) 
t 
throw new RuntimeException("stream is null"); 


} 
/* ”创建 临时 文件 */ 
File myTempFile = File.createTempFile("yinyue", "."+ 
getFileExtension (strPath)); 
currentTempFilePath = myTempFile.getAbsolutePath(); 
FileOutputStream fos = new FileOutputStream(myTempFile) ; 
byte buf[] = new byte[128]; 
do 
t 
int numread - is.read(buf); 
if (numread «- 0) 
t 
break; 
} 
fos.write(buf, 0, numread); 
)while (true); 


/* 直 到 fos 存储 完毕 ， 调 用 MediaPlayer.setDataSource */ 
mMediaPlayer01.setDataSource (currentTempFilePath); 
try 
t 

is.close(); 
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} 
catch (Exception ex) 
{ 
Log.e(TAG, "error: " + ex.getMessage(), ex); 
} 
} 
H 
) 


(5 定义 方法 getFileExtension(String strFileName) 来 获取 音乐 文件 的 扩展 名 ， 如 果 无 法 
顺利 获取 扩展 名 ， 则 默认 为 “.dat”。 具 体 代 码 如 下 : 
/* ”获取 音乐 文件 扩展 名 自 定义 函数 */ 


private String getFileExtension(String strFileName) 
{ 

File myFile = new File(strFileName); 

String strFileExtension-myFile.getName|(); 


strFileExtension- (strFileExtension.substring(strFileExtension.lastIndexO 
£(".")+1)) .toLowerCase (); 
if (strFileExtension=="") 
{ 
/* 如 果 无 法 顺利 获取 扩展 名 则 默认 为 .dat */ 
strFileExtension = "dat"; 
» 
return strFileExtension; 
L 
© 定义 方法 delFile(String strFileName) 来 设置 当 离开 程序 时 删除 临时 音乐 文件 ， 具 体 
代码 如 下 : 
/* 离开 程序 时 需要 调用 自 定义 函数 删除 临时 音乐 文件 */ 
private void delFile(String strFileName) 
t 
File myFile - new File(strFileName); 
if (myFile.exists()) 
t 
myFile.delete(); 


} 


@override 
protected void onPause() 
t 
//TODO Auto-generated method stub 


/* 删除 临时 文件 */ 
try 
t 
delFile (currentTempFilePath) ; 


} 
catch (Exception e) 
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t 
e.printStackTrace(); 
H 
super.onPause(); 
) 
) 


执行 后 可 以 通过 “播放 ”、“ 和 暂停 >” 、“ 
的 MP3 音乐 ， 如 图 11-2 所 示 。 


[IN 


新 播放 ”和 “停止 ”四 个 按钮 来 控制 指定 


图 11-2 执行 效果 


11.4 在 Android 中 下 载 在 线 铃 声 


在 日 常 的 手机 应 用 中 ， 我 们 经 常 从 网 络 上 下 载 一 个 MP3 文件 作为 手机 铃声 。 本 节 将 
通过 一 个 具体 实例 的 实现 过 程 ， 来 讲解 在 Android 系统 中 下 载 在 线 铃声 的 方法 。 


源码 路 径 


下 载 在 线 铃声 下 载 路 径 :\daima\l1\ling 


在 本 实例 中 ， 我 们 可 以 在 EditText 中 输入 一 个 MP3 的 网 址 ， 当 下 载 完成 此 网 址 的 
MP3 后 打开 RingtoneManager.ACTION RINGTONE PICKER 这 个 Intent， 在 打开 Intent 的 
同时 传 入 一 个 参数 ， 这 个 ACTION. RINGTONE PICKER 的 Intent 会 带 入 刚才 下 载 的 文件 
让 用 户 选择 。 在 具体 实现 过 程 中 ， 会 首先 判断 下 载 文件 是 否 完整 ， 并 判断 用 户 是 否 已 设置 
铃声 ， 会 以 SD 卡 中 的 铃声 文件 作为 存储 网 络 下 载 音乐 文件 的 路 径 ， 打 开 RingtoneManager 
的 ACTION RINGTONE PICKER 的 Intent 让 用 户 找到 下 载 的 音乐 ， 并 作为 铃声 。 

本 实例 的 主 程序 文件 是 lngjava。 具 体 实现 流程 如 下 。 

(1) 用 private 声明 系统 中 需要 的 对 象 ， 具 体 代码 如 下 : 


protected static final String APP TAG = "DOWNLOAD RINGTONE"; 
private Button mButtonl; 

private TextView mTextViewl; 

private EditText mEditTextl; 

private String strURL = ""; 

public static final int RINGTONE PICKED = 0x108; 

private String currentFilePath = ""; 

private String currentTempFilePath = ""; 

private String fileEx-""; 

private String fileNa-""; 

private String strRingtoneFolder - "/sdcard/music/ling"; 
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(2) 判断 是 否 包 含 文件 夹 “/sdcard/music/ringtones”， 如 果 不 存在 则 输出 提示 。 具 体 代 
人 码 如 下 : 


/** Called when the activity is first created. */ 


@Override 
public void onCreate (Bundle savedInstanceState) 
t 
super.onCreate (savedInstanceState); 
setContentView(R.layout.main); 


mButtonl -(Button) findViewById(R.id.myButtonl); 
mTextViewl = (TextView) findViewById(R.id.myTextViewl); 
mEditTextl = (EditText) findViewById(R.id.myEditText1) ; 
/* WER A /sdcard/music/ringtones 文件 夹 */ 
if(bIfExistRingtoneFolder (strRingtoneFolder)) 
i 

Log.i(APP TAG, "Ringtone Folder exists."); 
} 


(3) 使 用 fileEx 和 getFile 取得 远程 MP3 文件 的 名 称 ， 具 体 代码 如 下 : 


mButtonl.setOnClickListener (new Button.OnClickListener () 
{ 
@override 
public void onClick(View arg0) 
{ 
strURL = mEditTextl.getText().toString(); 
Toast.makeText (ling.this, getString(R.string.str msg) 
,Toast.LENGTH SHORT) .show(); 
/* 取 得 文件 名 称 */ 
fileEx = strURL.substring(strURL.lastIndexOf (".")+1, strURL. 
length()).toLowerCase(); 
fileNa = strURL.substring(strURL.lastIndexOf ("/")+1,strURL. 
lastIndexOf (".")); 
getFile(strURL); 


}); 
} 


(4) 定义 方法 getMIMEType(File 人 来 判断 文件 MimeType 的 打开 格式 ， 具 体 代码 如 下 : 


/* 判断 文件 MimeType ff] method */ 
private String getMIMEType (File f) 
{ 
String type=""; 
String fName-f.getName(); 
/* 取得 扩展 名 */ 
String end=fName.substring (fName.lastIndexOf(".")+1, 
fName. length () ) .toLowerCase () 7 
/* 依 扩展 名 的 类 型 决定 MimeType */ 
if (end.equals ("m4a") | | end. equals ("mp3") | | end. equals ("mid") | | 
end.equals ("xmf")||end.equals ("ogg") | | end. equals ("wav") ) 


0B 第 11 章 让 网 络 和 多 媒体 接轨 


t 
type = "audio"; 
} 
else if (end.equals ("3gp") | lend. equals ("mp4") ) 
t 
type - "video"; 
} 
else if (end.equals ("jpg") | |end. equals ("gif") || 
end.equals ("png") | lend.equals ("jpeg") | | 
end.equals ("bmp") ) 
t 
type - "image"; 
} 
else 
t 
type-"*"; 


) 
/* 如 果 无 法 直接 打开 ， 就 跳出 软件 列表 供用 户 选择 */ 
if(end.equals ("image") 
{ 
) 
else 
t 
type += "/*"; 
) 
return type; 
) 


(5) 定义 方法 getFile(final String strPath) 来 获取 MP3 文件 ， 如 果 地 址 和 当前 地 址 一 样 则 
直接 使 用 getDataSource 数据 ， 如 果 有 异常 则 输出 异常 信息 。 有 具体 代码 如 下 : 


private void getFile(final String strPath) 
t 
try 
t 
if (strPath.equals(currentFilePath) ) 
{ 
getDataSource (strPath) ; 
H 
currentFilePath = strPath; 
Runnable r = new Runnable() 


{ 

public void run() 

{ 
try 
{ 

getDataSource (strPath) ; 

} 
catch (Exception e) 
{ 


Log.e(APP TAG, e.getMessage(), e); 
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} 
Be 
new Thread (r) .start(); 
} 
catch (Exception e) 
{ 
e.printStackTrace (); 


(6) 定义 方法 getDataSource(String strPath) 来 获取 远程 文件 ， 如 果 地址 错误 则 输出 错误 
信息 。 上 基体 代码 如 下 : 
/* 取 得 运程 文件 */ 
private void getDataSource(String strPath) throws Exception 
t 
if (!URLUtil.isNetworkUrl (strPath) ) 
t 
mTextViewl.setText ("错误 的 URL"); 
} 
else 
t 
/* 取 得 URL*/ 
URL myURL = new URL(strPath); 
/* 创 建 连接 */ 
URLConnection conn = myURL.openConnection(); 
conn.connect () ; 
/*InputStream 下 载 文件 */ 
InputStream is = conn.getInputStream(); 
if (is == null) 
t 
throw new RuntimeException("stream is null"); 
H 


/* 创 建文 件 地 址 */ 
File myTempFile = new File("/sdcard/music/ling/", 
fileNat+"."+fileEx); 

/* 取 得 在 暂 存盘 的 路 径 */ 
currentTempFilePath = myTempFile.getAbsolutePath(); 
/* 将 文件 写 入 暂 存 盘 */ 
FileOutputStream fos = new FileOutputStream(myTempFile) ; 
byte buf[] = new byte[128]; 
do 
t 

int numread - is.read (buf); 

if (numread «- 0) 

t 

break; 

} 

fos.write (buf, 0, numread); 
}while (true); 


0B 第 11 章 让 网 络 和 多 媒体 接轨 


(7) 打开 RingtonManager 以 选择 铃声 ， 通 过 Intent HR intent 来 设置 铃声 ， 然 后 设置 
显示 铃声 的 文件 夹 和 显示 铃声 开头 。 如 果 有 异常 则 输出 异常 。 具 体 代 码 如 下 : 


/* 打开 RingtonManager 进行 铃声 选择 */ 
String uri = null; 
if(bIfExistRingtoneFolder (strRingtoneFolder)) 
t 
/* 设 置 铃声 */ 
Intent intent = new Intent( RingtoneManager. 
ACTION RINGTONE PICKER); 
/* 设 置 显示 铃声 的 文件 夹 */ 
intent.putExtra( RingtoneManager.EXTRA RINGTONE TYPE, 
RingtoneManager.TYPE RINGTONE); 
/* 设 置 显示 铃声 开头 */ 
intent.putExtra( RingtoneManager.EXTRA RINGTONE TITLE, 
"设置 铃声 ") ; 
if( uri != null) 
t 
intent.putExtra( RingtoneManager. 
EXTRA RINGTONE EXISTING URI, Uri.parse( uri)); 
} 
else 
{ 
intent.putExtra( RingtoneManager. 
EXTRA RINGTONE EXISTING URI, (Uri)null); 
} 
startActivityForResult (intent, RINGTONE PICKED); 


try 
{ 
is.close(); 
} 
catch (Exception ex) 
{ 
Log.e(APP TAG, "error: " + ex.getMessage(), ex); 
} 


} 


(8) 定义 方法 onActivityResult 根据 用 户 选择 的 铃声 设置 保存 对 应 的 信息 。 当 选择 完毕 
后 ， 再 次 返回 选择 Activity 界面 。 具 体 代码 如 下 : 


protected void onActivityResult (int requestCode, 
int resultCode, Intent data) 
t 
if (resultCode !- RESULT OK) 
t 
return; 
t 
switch (requestCode) 
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{ 


case (RINGTONE PICKED): 
try 
t 
Uri pickedUri - data.getParcelableExtra 
(RingtoneManager.EXTRA RINGTONE PICKED URI); 
if (pickedUri!-null) 
t 
RingtoneManager.setActualDefaultRingtoneUri 
(ling.this,RingtoneManager.TYPE RINGTONE, 
pickedUri); 


} 
catch (Exception e) 
{ 
e.printStackTrace(); 
} 
break; 
default: 

break; 

} 

super.onActivityResult (requestCode, resultCode, data); 

} 


(9) 定义 bIfExistRingtoneFolder 来 判断 是 否 包含 文件 夹 “/sdcard/music/ringtones”， 具 
体 代码 如 下 : 


/* 判 断 是 否 包含 “/sdcard/music/ringtones 文件 夹 ”*/ 
private boolean bIfExistRingtoneFolder(String strFolder) 


t 
boolean bReturn - false; 


File f - new File(strFolder); 
if(!f.exists()) 
{ 
/* i) /sdcard/music/ringtones 文件 夹 */ 
if (£.mkdirs()) 
{ 
bReturn 
} 
else 


{ 
bReturn = false; 


true; 


} 


else 


{ 
bReturn = true; 


} 
return bReturn; 


执行 后 会 先 显示 一 个 下 载 界 面 ， 单 
如 图 11-3 所 示 。 下 载 完成 后 会 弹出 一 个 界 


设置 。 


11.5 


文件 上 传 对 于 广大 i 
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击 下 载 ” 按 钮 开始 下 载 指定 的 MP3 文件 ， 
。 选 择 一 种 选项 ， 并 单 击 OK 按钮 完成 铃声 


£N 3 


http://www.Irn.cn/zywh/xyyy/ 
yyxs/200805/ 
W020080505536315331317.mp3 


点 击 下 载 


图 11-3 执行 效果 


在 Android 中 上 传 文件 到 远程 服务 器 


志 者 来 说 并 不 陌生 ， 在 手机 中 我 们 同样 可 以 实现 网 站 上 传 功能 。 本 


节 将 通过 一 个 具体 实例 的 实现 过 程 ， 介 绍 在 Android 中 上 传 文件 的 基本 流程 。 


源码 路 径 


上 传 文件 到 远程 服务 器 下 载 路 径 :\daima\l1\chuan 


(1) 编写 布局 


<TextView 
android: 
android: 
android: 
android: 
android: 
android: 
android: 
android: 
e 


文件 main.xml， 主 要 代码 如 下 : 


id="@+id/myText1" 

layout width="wrap content" 
layout height="wrap content" 
text="@string/str title" 
textSize="20sp" 
textColor="@drawable/black" 
layout x="10px" 

layout y="12px" 


</TextView> 


<TextView 
android: 
android: 
android: 
android: 
android: 
android: 
android: 

> 


id="@+id/myText2" 

layout width="wrap content" 
layout height="wrap content" 
textSize="16sp" 
textColor="@drawable/black" 
layout x="10px" 

layout y="52px" 


</TextView> 


<TextView 
android: 
android: 


id="@+id/myText3" 
layout width-"wrap content" 


> Andioid sasaiA nma 


android:layout height-"wrap content" 
android:textSize="16sp" 
android: textColor="@drawable/black" 
android:layout x="10px" 
android: layout_y="102px" 

> 

</TextView> 

<Button 
android: id="@+id/myButton" 
android:layout width="92px" 
android: layout height="49px" 
android:text="@string/str button" 
android: textSize="15sp" 
android:layout x="90px" 
android:layout y="170px" 

> 

</Button> 


(2) 编写 主 程序 文件 chuan.java， 其 具体 实现 流程 如 下 。 
© 分 别 声明 变量 newName、uploadFile 和 actionUrl， 具 体 代 码 如 下 : 


public class chuan extends Activity 
{ 
/* 变量 声明 
* newName: 上 传 后 在 服务 器 上 的 文件 名 称 
* uploadFile: 要 上 传 的 文件 路 径 
* actionUrl: 服务 器 上 对 应 的 程序 路 径 */ 
private String newName-"image.jpg"; 
private String uploadFile-"/data/data/irdc.example9/image.jpg"; 
private String actionUrl="http://127.127.0.1/upload/upload.jsp"; 
private TextView mTextl; 
private TextView mText2; 
private Button mButton; 


Q) 通过 mTextl 对 象 获取 文件 路 径 ， 根 据 mText2 设置 上 传 网 址 ， 单 击 按钮 后 调用 上 
传 方法 uploadFile0。 有 具体 代码 如 下 : 


public void onCreate (Bundle savedInstanceState) 
t 
super.onCreate (savedInstanceState); 
setContentView (R.layout.main); 
mTextl = (TextView) findViewById(R.id.myText2); 
mTextl.setText (" 文 件 路 径 : \n"+uploadFile) ; 
mText2 = (TextView) findViewById(R.id.myText3); 
mText2.setText ("上 传 网 址 : Nn"*actionUrl); 
/* 设置 mButton 的 onclick 事件 处 理 */ 
mButton = (Button) findViewById(R.id.myButton); 
mButton.setOnClickListener (new View.OnClickListener () 
{ 
public void onClick(View v) 
{ 
uploadFile(); 
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He 
F 


© 定义 方法 uploadFile0 将 文件 上 传 至 Server， 具 体 代码 如 下 : 
/* 上 传 文件 至 server 的 方法 */ 


private void uploadFile() 
t 
String end = "\r\n"; 
String twoHyphens - "--"; 
String boundary = "*****"; 
try 
t 
URL url -new URL (actionUrl); 
HttpURLConnection con- (HttpURLConnection)url.openConnection(); 
/* 允许 Input. Output, 不 使 用 Cache */ 
con.setDoInput (true); 
con.setDoOutput (true); 
con.setUseCaches (false); 
/* 设置 传送 的 method=POST */ 
con.setRequestMethod ("POST"); 
/* setRequestProperty */ 
con.setRequestProperty ("Connection", "Keep-Alive"); 
con.setRequestProperty("Charset", "UTF-8"); 
con.setRequestProperty ("Content-Type", 
"multipart/form-data;boundary="+boundary) ; 
/* 设置 Dataoutputstream */ 
DataOutputStream ds = 
new DataOutputStream(con.getOutputStream()); 
ds.writeBytes (twoHyphens + boundary + end); 
ds .writeBytes ("Content-Disposition: form-data; " + 
"name=\"filel\";filename=\"" + 
newName +"\"" + end); 
ds .writeBytes (end); 
/* 取得 文件 的 FileInputStream */ 
FileInputStream fStream = new FileInputStream(uploadFile) ; 
/* 设置 每 次 写 入 1024 字 节 */ 
int bufferSize = 1024; 
byte[] buffer = new byte[bufferSize]; 
int length - -1; 
/* 从 文件 读 取 数据 至 缓冲 区 */ 
while((length = fStream.read(buffer)) !- -1) 
t 
/* 将 资料 写 入 DataoutputStream 中 */ 
ds.write(buffer, 0, length); 
} 
ds.writeBytes (end); 
ds.writeBytes (twoHyphens + boundary + twoHyphens + end); 
fStream.close(); 
ds.flush(); 
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/* WẸ Response WẸ */ 


InputStream is = con.getInputStream(); 


int ch; 
StringBuffer b -new StringBuffer (); 
while( ( ch = is.read() ) != -1 ) 


t 
b.append( (char)ch ); 

} 
/* f Response 显示 在 对 话 框 中 */ 
showDialog (b.toString().trim()); 
/* XH] Dataoutputstream */ 
ds.close(); 

H 

catch (Exception e) 

t 
showDialog (""+e); 

} 

) 


@ 定义 方法 showDialog(String mess) 来 显示 提示 对 话 框 ， 有 具体 代码 如 下 : 
/* 显示 Dialog 的 方法 */ 


private void showDialog(String mess) 
t 
new AlertDialog.Builder (example9.this) .setTitle ("Message") 
-setMessage (mess) 
.setNegativeButton (" 确 定 ",new DialogInterface.OnClickListener() 
t 
public void onClick(DialogInterface dialog, int which) 
t 
} 
}) 
-Show(); 


执行 后 单 击 “ 上 传 ”按钮 可 以 将 指定 的 文件 上 传 到 服务 器 ， 如 图 11-4 所 示 。 


上 传 到 服务 器 


文件 路 径 : 
/data/data/irdc.shili9/image. 


Pem : 


http://127.127.0.1/upload/upload.jsp 


Lf 


图 11-4 执行 效果 
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11.6 在 Android 中 开发 一 个 远程 下 载 系 统 


在 Android 系统 中 可 以 安装 .APK 格式 的 文件 ， 所 以 本 节 将 通过 一 个 具体 实例 的 实现 过 
程 ， 讲 解 开发 能 够 远程 下 载 .APK 格式 文件 的 过 程 。 


11.6.1 基础 知识 介绍 


APK 是 Android Package 的 缩写 ， 即 Android 安装 包 。APK 是 类 似 Symbian Sis 或 Sisx 
的 文件 格式 。 通 过 将 APK 文件 直接 传 到 Android 模拟 器 或 Android 手机 中 执行 即 可 安装 。 

APK 文件 和 Sis 一 样 最终 把 Android SDK 编译 的 工程 打包 成 一 个 安装 程序 文件 ， 格 式 
为 APK. APK 文件 其 实 是 zip 格式 ， 但 后 级 名 被 修改 为 APK， 通 过 UnZip 解压 后 ， 可 以 
看 到 Dex 文件 ，Dex 是 Dalvik VM executes 的 全 称 ， 即 Android Dalvik 执行 程序 ， 并 非 
Java ME 的 字 节 码 ， 而 是 Dalvik 字 节 码 。 一 个 APK 文件 结构 为 : META-INF\Jar， 此 文件 
结构 的 具体 说 明 如 下 。 

Q res: 存放 资源 文件 的 目录 。 

Q > AndroidManifestxml: 程序 全 局 配置 文件 。 

Q classesdex: Dalvik 字 节 码 。 

Q  resourcesarsc: 编译 后 的 二 进 制 资源 文件 。 

Android 在 运行 一 个 程序 时 ， 首 先 需 要 UnZip 解压 缩 ， 这 一 点 和 Symbian 比较 相似 ， 
而 和 Windows Mobile 中 的 PE 文件 有 所 区 别 。 这 样 做 对 于 程序 的 保密 性 和 可 靠 性 不 是 很 
高 ， 通 过 dexdump 命令 可 以 反 编译 ， 但 这 样 做 符合 发 展 规律 ， 微 软 的 Windows Gadgets 或 
者 说 WPF 也 采用 了 这 种 构架 方式 。 在 Android 平台 中 Dalvik vm 的 执行 文件 被 打包 为 APK 
格式 ， 最 终 运 行 时 加 载 器 会 解压 然后 获取 编译 后 的 androidmanifestxml 文件 中 的 
permission 分 支 相关 的 安全 访问 ， 但 仍然 存在 很 多 安全 限制 ， 如 果 你 将 APK 文件 传 到 
/system/app 文件 夹 下 会 发 现 执行 是 不 受 限 制 的 。 我 们 平时 安装 的 文件 可 能 不 是 这 个 文件 
夹 ， 而 在 Android ROOM 中 系统 的 APK 文件 默认 会 放 入 该 文件 夹 ， 它 们 具有 ROOT 权限 。 

1. 下 载 APK 应 用 程序 

我 们 可 以 从 哪里 取得 好 用 的 Android APK 应 用 程序 ， 并 安装 到 Android 手机 上 呢 ? 对 
拥有 G1 实体 手机 的 使 用 者 而 言 ，Android Market 就 是 最 佳 的 地 方 ， 只 要 使 用 手机 内 应 用 
程序 列表 的 Market 程序 ， 就 可 以 直接 连接 到 Android Market， 而 点 选 喜爱 的 应 用 程序 后 ， 
就 会 直接 下 载 并 安装 到 G1 手机 上 。 不 过 对 使 用 Android 仿真 器 的 使 用 者 而 言 ， 就 没有 如 
此 方便 了 ，Android 仿真 器 并 没有 Android Market 应 用 程序 ， 只 能 使 用 内 附 的 浏览 器 浏览 
Android Market。 为 何 说 是 浏览 呢 ? 因为 Android Market 不 是 采用 通用 网 页 浏览 方式 来 下 
载 文 件 ， 虽 然 可 以 使 用 常见 的 浏览 器 看 到 Android Market 上 的 应 用 程序 ， 但 却 没有 办 法 下 
载 到 Android 仿真 器 或 一 般 的 计算 机 上 ， 而 Android Market 采用 特有 的 网 页 API， 使 用 
Native UI 的 方式 来 访问 ， 只 有 通过 内 建 在 Gl 手机 内 的 Market 应 用 程序 ， 才 能 下 载 
Android Market 网 页 中 的 应 用 程序 ， 并 自动 安装 到 G1 手机 上 。 
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所 以 Android 仿真 器 的 使 用 者 ， 只 好 浏览 该 网 页 上 的 应 用 程序 ， 然 后 通过 搜索 引擎 去 
找 找 看 有 没有 开发 人 员 将 应 用 程序 放 到 Android Market 之 后 ， 还 另外 将 APK 文件 放置 在 
一 般 网 页 上 了 。 到 此 为 止 ， 使 用 Android 仿真 器 的 用 户 ， 也 不 需要 这 么 灰心 ， 因 为 有 太 多 
的 人 遇 到 同样 的 问题 ， 也 就 生成 非常 多 的 Android 应 用 程序 网 页 ， 你 可 以 浏览 这 些 网 页 并 
把 上 面 的 APK 文件 下 载 到 一 般 计 算 机 上 ， 再 安装 到 Android 仿真 器 上 。 
下 面 列 出 了 常用 的 APK 应 用 程序 下 载 网 站 : 
Q http://andappstore.com/ 
Q http:/www.getjar.com/software 
Q http://www.phoload.com/android 
Q http://slideme.org/ 
Q http://androidforums.com/market/ 
Q  http//www.cyrket.com/ 
Q  http//www.androidfreeware.org/ 
口 
口 
Q 
Q 
2. 


http://androidsoftwaredownload.com/ 

http://www. freeandroidsoft.com/ 
http://code.google.com/p/apps-for-android/ 
http://code.google.com/p/openintents/downloads/list 


安装 APK 应 用 程序 
所 有 的 APK 应 用 程序 要 安装 到 Android 仿真 器 上 ， 使 用 adb install 指令 来 开启 一 个 命 
令 字 符 的 终端 机 窗口 ， 并 运行 APK 安装 指令 : 
adb install filename.apk 


这 样 adb 指令 就 会 自动 将 filename.apk 应 用 程序 安装 到 Android 仿真 器 上 ， 而 仿真 器 
上 的 应 用 程序 列表 也 会 立即 出 现 刚刚 安装 的 应 用 程序 图 标 。 如 果 应 用 程序 没有 安装 成 功 ， 
或 安装 不 完善 ， 也 可 以 重复 运行 adb install -r filename.apk 指令 重新 安装 一 次 ， 这 样 会 保留 
已 经 设置 的 信息 ， 而 仅 是 重新 安装 应 用 程序 本 身 。 

不 过 在 运行 adb 安装 APK 应 用 程序 组 件 时 ， 不 能 同时 运行 多 个 Android 仿真 器 ， 因 为 
adb 不 知 要 将 APK 应 用 程序 安装 到 哪 一 个 仿真 器 ， 最 好 的 方法 就 是 仅 运行 一 个 Android {ij 
真 器 。 如 果 有 同时 运行 多 个 仿真 器 的 需要 ， 就 要 在 安装 APK 组 件 时 ， 使 用 ado 先 指定 某 
一 个 仿真 器 。 可 以 从 Android 仿真 器 的 窗口 上 ， 看 到 类 似 “Android Emulator(5554)” 的 字 
样 ， 而 5554 就 是 仿真 器 的 运行 序号 ， 每 一 个 仿真 器 有 其 独特 的 运行 序号 ， 只 要 将 adb 加 
上 -s <serialNumber> 参数 ， 就 可 以 指定 adb 将 APK 应 用 程序 安装 在 哪 一 个 仿真 器 上 了 : 


adb -s emulator-5554 install filename.apk 


(指定 安装 APK 组 件 在 5554 的 Android 仿真 器 中 ) 


3. 移 除 APK 应 用 程序 


如 果 已 经 安装 了 很 多 Android 应 用 程序 ， 若 想 删除 一 些 应 用 程序 图 标 也 非常 简单 ， 同 
样 是 一 行 指令 就 搞定 了 。adb uninstall 指令 可 以 将 APK 应 用 程序 移 除 : 


adb uninstall package 


0B 第 11 章 让 网 络 和 多 媒体 接轨 
例如 下 面 的 代码 : 
adb uninstall com.android.email (把 E-mail 程序 移 除 ) 
Android 使 用 的 package 名 称 类 似 我 们 浏览 网 页 时 常用 的 域名 方式 ， 所 以 上 面 的 示范 是 
将 com.android.email 这 个 email package 移 除 。 请 记 住 ，package 名 称 不 是 您 安装 APK 组 件 
时 的 文件 名 或 是 显示 在 Android 仿真 器 中 的 应 用 程序 名 称 。 另 外 Package 名 称 也 并 不 一 定 
都 是 com.android 这 样 的 形式 ， 它 可 以 是 各 式 各 样 的 域名 方式 来 命名 ， 例 如 org.iiiro.iiivpa 
或 com.deafcode.android.Cinema. APK 文件 的 Package 名 称 完全 是 由 当初 的 开发 人 员 所 
制定 的 ， 所 以 并 没有 统一 的 命名 方式 ， 唯 一 相同 的 就 是 它 一 定 是 类 似 Domain 域名 的 命名 


格式 。 

另外 ， 在 移 除 该 APK 应 用 程序 时 ， 如 果 想 要 保留 信息 与 Cache 目录 ， 则 加 上 -k 参数 
即 可 。 

adb uninstall -k package ( 移 除 程序 时 ， 保 留 信息 ) 


不 过 麻烦 的 是 ， 可 能 不 知道 这 个 想 要 移 除 的 应 用 程序 的 Package 名 称 ， 所 以 必须 先 运 
1f adb shell 进入 Android 操作 系统 的 指令 列 模 式 ， 然 后 到 /data/data 或 /data/app 目录 下 ， 
得 知 欲 移 除 的 Package 名 称 ， 然 后 使 用 adb uninstall 指令 删除 APK 应 用 程序 ， 这 样 就 可 以 
简易 地 从 Android 仿真 器 中 将 不 想 使 用 的 APK 应 用 程序 移 除 了 。 


adb shell 
ls /data/data 或 /data/app (查询 Package 名 称 ) 
exit 
adb uninstall package ( 移 除 查 询 到 的 Package) 


幸运 的 是 ， 从 Android SDK 1.5 版 起 ， 已 经 内 建 应 用 程序 管理 系统 ， 不 需要 再 辛苦 
使 用 adb uninstall 指令 移 除 APK 应 用 程序 组 件 ， 只 要 在 Android 手机 主 界面 点 击 MENU fë 
键 ， 然 后 依 序 点 击 “Settings 一 Applications 一 Manage applications” 命 令 ， 就 可 以 启动 应 用 
程序 管理 系统 。 当 前 Android 系统 已 经 安装 的 所 有 应 用 程序 都 会 罗列 出 来 ， 您 只 要 点 选 想 
要 移 除 的 应 用 程序 然后 选择 uninstall 就 可 以 移 除 该 程序 了 ， 这 样 就 不 需要 使 用 adb uninstall 
指令 来 移 除 Android 应 用 程序 了 。 

下 载 文件 与 打开 网 页 是 一 样 的 ， 打 开 网 页 是 将 内 容 显示 出 来 ， 保 存 文件 就 是 保存 到 文 
件 中 。 例 如 可 以 通过 下 面 的 代码 将 内 容 保存 到 SD 卡 等 设备 上 。 

public void downFile(String url, String path, String fileName) 

throws IOException { 


if (fileName == null || fileName == "") 
this.FileName = url.substring(url.lastIndexOf("/") + 1); 
else 


this.FileName = fileName; // 取得 文件 名 ， 如 果 输 入 新 文件 名 ， 则 使 用 新 文件 名 
URL Url = new URL (url); 
URLConnection conn = Url.openConnection(); 
conn.connect () ; 
InputStream is = conn.getInputStream(); 
this.fileSize = conn.getContentLength(); // 根据 响应 获取 文件 大 小 
if (this.fileSize «- 0) ( // 获取 内 容 长 度 为 0 
throw new RuntimeException ("无 法 获知 文件 大 小 ") ; 
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if (is == null) { // 没有 下 载 流 

sendMsg (Down ERROR); 

throw new RuntimeException (" 无 法 获取 文件 ") ; 
} 


FileOutputStream FOS = new FileOutputStream(path + this.FileName) ; 
// 创建 写 入 文件 内 存 流 ， 通 过 此 流向 目标 写 文件 

byte buf[] = new byte[1024]; 

downLoadFilePosition = 0; 

int numread; 

while ((numread = is.read(buf)) != -1) ( 
FOS.write(buf, 0, numread); 
downLoadFilePosition += numread 

} 

try ( 
is.close(); 

} catch (Exception ex) { 


; 


) 


11.6.2 具体 实现 


本 实例 的 功能 是 ， 能 够 远程 下 载 指定 网 址 的 Android 应 用 程序 ， 下 载 到 手机 后 打开 
application installer 软件 来 安装 这 个 软件 。 在 具体 实现 上 ， 先 设置 一 个 EditText 来 获取 远程 
URL， 然 后 通过 自 定义 按钮 打开 下 载 程序 (使 用 javanet 的 URLConnection 对 象 来 创建 连 
接 ， 通 过 InputStream 将 下 载 文件 写 入 到 存储 卡 的 缓存 )， 下 载 后 通过 自 定 义 方法 openFile() 
打开 文件 ， 并 根据 文件 扩展 名 ， 判 断 是 否 为 APK 格式 ， 如 果 是 则 启动 内 置 的 Install 程 
序 ， 开 始 安装 。 安 装 完成 后 ， 在 离开 Install 时 通过 方法 delFile0 将 存储 卡 中 的 临时 文件 删除 。 


实例 11-4 开发 一 个 远程 下 载 系统 下 载 路 径 :\daima\l1\xia 


本 实例 的 具体 实现 流程 如 下 。 
(1) 编写 布局 文件 main.xml， 主 要 代码 如 下 : 


<TextView 
android: id="@+id/myTextViewl" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:text="@string/str text" 

> 

</TextView> 

<EditText 
android:id="@+id/myEditText1" 
android:layout width="fill parent" 
android:layout height="wrap content" 
android:text="@string/str_url" 
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android:textSize-"18sp" 

> 

</EditText> 

<Button 
android: id="@+id/myButton1" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:text="@string/str button" 

> 

</Button> 


(2) 编写 主 程序 文件 xiajava， 其 具体 实现 流程 如 下 : 
QD 单 击 按钮 后 设置 将 文件 下 载 到 local 本 地 ， 获 取 要 安装 程序 的 文件 名 称 。 具 体 代码 
如 下 : 


mButton01.setOnClickListener (new Button.OnClickListener() 
{ 
public void onClick(View v) 
{ 
/* 文件 会 下 载 至 local 端 */ 
mTextView0l.setText (" 下 载 中 . . .") ; 
StrURL = mEditText0l.getText().toString(); 
/* 取 得 欲 安装 程序 的 文件 名 称 */ 
fileEx = strURL.substring(strURL.lastIndexOf(".") 
+1,strURL.length()) .toLowerCase () ; 
fileNa = strURL.substring(strURL.lastIndexOf ("/") 
+1,strURL.lastIndexof (".")); 
getFile(strURL); 
} 
} 
); 


Q) 如 果 文 本 框 中 的 远程 地 址 为 空 ， 则 输出 “请 输入 URL” 的 提示 。 具 体 代 码 如 下 : 


mEditText01.setOnClickListener (new EditText.OnClickListener() 
t 
@override 
public void onClick(View arg0) 
t 
// TODO Auto-generated method stub 
mEditText0l.setText (""); 
mTextView01.setText ("远程 安装 程序 (请 输入 URL) ") ; 


}); 
t 
@ 定义 方法 getFile(final String strPatb) 来 获取 下 载 的 URL 文件 ， 如 果 有 异常 则 输出 提 
m. BARRES T: 


/* 处 理 下 载 URL 文件 自 定义 函数 */ 
private void getFile(final String strPath) { 
try 
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if (strPath.equals(currentFilePath) ) 
{ 
getDataSource (strPath); 
} 
currentFilePath = strPath; 
Runnable r = new Runnable() 
{ 
public void run() 
{ 
try 
{ 
getDataSource (strPath) ; 
} 
catch (Exception e) 
{ 
Log.e (TAG, e.getMessage(), e); 
} 
} 
n 
new Thread(r).start(); 
) 
catch(Exception e) 
t 
e.printStackTrace(); 
) 
) 


® 定义 方法 getDataSource 来 获取 远程 文件 ， 主 要 代码 如 下 : 
/* 取 得 远程 文件 */ 


private void getDataSource(String strPath) throws Exception 
t 
if (!URLUtil.isNetworkUrl (strPath)) 
t 
mTextViewOl.setText (" 错 误 的 URL") ; 
5 
else 
t 
/* 取 得 URL*/ 
URL myURL = new URL(strPath); 
/* 创 建 连接 */ 
URLConnection conn = myURL.openConnection(); 
conn.connect () ; 
/*InputStream 下 载 文件 */ 
InputStream is = conn.getInputStream(); 
if (is == null) 
t 
throw new RuntimeException ("stream is null"); 


} 
/* 创 建 临 时 文件 */ 
File myTempFile = File.createTempFile(fileNa, "."+fileEx); 
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/* 取 得 暂 存 盘 的 路 径 */ 
currentTempFilePath = myTempFile.getAbsolutePath(); 
/* 将 文件 写 入 暂 存 盘 */ 
FileOutputStream fos = new FileOutputStream(myTempFile) ; 
byte buf[] = new byte[128]; 
do 
t 

int numread - is.read(buf); 

if (numread «- 0) 

t 

break; 

} 

fos.write(buf, 0, numread); 
)while (true); 


/* 打 开 文 件 进行 安装 */ 
openFile (myTempFile); 
try 
{ 
is.close(); 
} 
catch (Exception ex) 
{ 
Log.e(TAG, "error: " + ex.getMessage(), ex); 
} 
) 
} 


© 定义 方法 openFile(File 来 设置 在 手机 上 打开 文件 ， 主 要 代码 如 下 : 
/* 在 手机 上 打开 文件 的 method */ 


private void openFile(File f) 

t 
Intent intent = new Intent(); 
intent.addFlags(Intent.FLAG ACTIVITY NEW TASK); 
intent.setAction(android.content.Intent.ACTION VIEW); 


/* 调用 getMIMEType () 来 取得 MimeType */ 
String type = getMIMEType (f); 
/* 设置 intent 的 file 5 MimeType */ 
intent.setDataAndType (Uri.fromFile(f),type); 
startActivity (intent); 

} 

/* 判断 文件 MimeType ff] method */ 

private String getMIMEType (File f) 

t 
String type-"" 
String fName=f.getName () ; 
/* 取得 扩展 名 */ 
String end=fName.substring (fName.lastIndexOf (".") 
+1, f£Name.length()) .toLowerCase (); 


/* 依 扩展 名 的 类 型 决定 MimeType */ 
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if (end.equals ("m4a") | | end. equals ("mp3") | | end. equals ("mid") | | 
end.equals ("xmf")| |end.equals ("ogg") | | end.equals ("wav") ) 
t 
type = "audio"; 
} 
else if (end.equals ("3gp") | |end.equals ("mp4") ) 
{ 
type = "video"; 
} 
else if(end.equals ("jpg") | |end.equals ("gif") | |end.equals ("png") | | 
end.equals ("jpeg") | |end.equals ("bmp") ) 
t 
type = "image"; 
} 
else if (end.equals ("apk")) 
{ 
/* android.permission. INSTALL PACKAGES */ 
type = "application/vnd.android.package-archive"; 
} 
Sle 
{ 
Eype-mem 


) 
/* 如 果 无 法 直接 打开 ， 就 跳出 软件 列表 供用 户 选择 */ 
if(end.equals ("apk")) 
{ 
) 
else 
t 
type += "/*"; 
) 
return type; 
É 


© 定义 方法 delFile 来 删除 SD 卡 上 的 临时 文件 ， 主 要 代码 如 下 : 
/* 自 定义 删除 文件 方法 */ 


private void delFile(String strFileName) 
t 

File myFile - new File(strFileName); 

if (myFile.exists()) 

d 

myFile.delete(); 

} 

} 


CD 定义 方法 onPause()fll onResume0， 分 别 设置 onPause 暂停 和 onResume 
的 状态 。 具 体 代码 如 下 : 
/* 当 Activity 处 于 onPause 状态 时 ， 更 改 TextView 文字 状态 */ 


@Override 
protected void onPause() 
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{ 
mTextView01 = (TextView)findViewById (R.id.myTextViewl); 


mTextView01.setText (" 下 载 成 功 ") ; 
super.onPause(); 


) 

/*?*5 Activity 处 于 onResume 状态 时 ， 删 除 临 时 文件 */ 
@override 

protected void onResume() 


t 
// TODO Auto-generated method stub 


/* 删除 临时 文件 */ 
delFile(currentTempFilePath); 
super.onResume (); 
) 
} 
执行 后 将 在 文本 框 中 显示 目标 安装 程序 的 路 径 ， 如 图 11-5 所 示 。 实 例 中 的 默认 路 径 是 
http://mz.ruan8.com/soft/2/sougoushoujishurufa 7786.apk， 这 是 一 个 sogou 输入 法 程序 。 单 击 
“安装 ”按钮 后 ， 开 始 下 载 目标 文件 ， 如 图 11-6 所 示 。 下 载 完 成 后 弹出 安装 界面 ， 单 击 


Install 按钮 后 开始 安装 ， 安 装 完成 后 输出 提示 。 


AME 2:23 am 
[2 com.sohu.inputmethod... 


Installing... 


BSS 


http://mz.ruan8.com/soft/2/ 
ushoujishurufa 7786.apk 


图 11-5 下 载 目标 文件 1-6 TRH 


11.7 在 Android 中 开发 一 个 网 络 视 频 播 放 器 


目前 智能 手机 都 可 以 远程 观看 在 线 视频 ， 通 常 视 频 都 比较 大 ， 所 以 必须 保证 手机 空间 
能 够 存储 ， 另 外 还 要 确保 下 载 的 视频 能 够 被 MediaPlayer 所 支持 。 在 本 实例 中 ， 通 过 
EditText 来 获取 远程 视频 的 URL， 然 后 将 此 网 址 的 视频 下 载 到 手机 的 存储 卡 中 ， 以 暂 存 的 
方式 保存 在 SD 卡 中 ， 再 通过 控制 按钮 来 控制 对 视频 的 处 理 。 在 播放 完毕 并 终止 程序 后 ， 
将 暂 存 到 SD 卡 中 的 临时 视频 删除 。 
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x 例 Ij 能 源码 路 径 
实例 11-5 使 用 MediaPlayer 播放 网 络 中 的 视频 下 载 路 径 :\daima\l1\bof 


11.7.4 实现 布局 文件 
本 实例 的 布局 文件 是 main.xml， 主 要 代码 如 下 : 


<?xml version-"1.0" encoding-"utf-8"?» 
<LinearLayout 
xmlns:android-"http://schemas.android.com/apk/res/android" 
android:background="@drawable/white" 
android: orientation="vertical" 
android:layout width="fill parent" 
android:layout height="fill parent" 
> 
<TextView 
android: id="@+id/myTextViewl" 
android:layout width="fill parent" 
android: layout height="wrap content" 
android: textColor="@drawable/blue" 
android:text="@string/hello" /> 
<EditText 
android: id="@+id/myEditText1" 
android: layout width="wrap content" 
android: layout height="wrap content" 
android:text="" 
android:singleLine="True" /> 
<SurfaceView 
android: id="@+id/mSurfaceViewl" 
android:visibility="visible" 
android:layout width="320px" 
android: layout height="240px"> 
</SurfaceView> 
<LinearLayout 
android:orientation-"horizontal" 
android:layout height-"wrap content" 
android:layout width-"fill parent" 
android:padding-"10dip" 
= 
<ImageButton android: id="@+id/play" 
android: layout height="wrap content" 
android:layout width="wrap content" 
android:src="@drawable/play" 
/> 
<ImageButton android:id="@+id/pause" 
android:layout height="wrap content" 
android:layout width="wrap content" 
android: src="@drawable/pause" 
/> 
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<ImageButton android:id="@+id/reset" 
android:layout height-"wrap content" 
android:layout width-"wrap content" 
android: src="@drawable/reset" 

/> 

<ImageButton android:id="@+id/stop" 
android:layout height="wrap content" 
android:layout width="wrap content" 
android: src="@drawable/stop" 

TS 

</LinearLayout> 

</LinearLayout> 


11.7.2 ”实现 显示 文本 值 文 件 
本 实例 的 屏幕 显示 文本 值 文件 是 stings xml， 具 体 代码 如 下 : 


<?xml version-"1.0" encoding-"utf-8"?» 
«resources» 

«string name="hello"></string> 

«string name="app name"></string> 

«string name="str_play"> 播 放 中 </string> 

«string name="str_done"> 播 放 完毕 </string> 

«string name="str_pause">#if#</string> 

«string name="str_stop">f#ik</string> 

«string name="str err nosd">※ 没 有 安装 SD 存储 卡 ※</string> 
</resources> 


11.7.3” 主 程序 文件 


本 实例 的 主 程序 文件 是 bofjava， 其 具体 实现 流程 如 下 。 
(1) 定义 bIsReleased 来 标识 MediaPlayer 是 否 已 被 释放 ， 识 别 MediaPlayer 是 否 正 处 于 
暂停 ， 并 用 LogCat 输出 TAG filter。 具 体 代 码 如 下 : 
/* 识别 MediaPlayer 是 否 已 被 释放 */ 
private boolean bIsReleased = false; 
/* 识别 MediaPlayer 是 否 正 处 于 暂停 */ 
private boolean bIsPaused = false; 
/* LogCat 输出 TAG filter */ 
private static final String TAG = "HippoMediaPlayer"; 
private String currentFilePath = ""; 
private String currentTempFilePath = ""; 
private String strVideoURL - ""; 


(2) 设置 播放 视频 的 URL 地 址 ， 使 用 mSurfaceView01 来 绑 定 Layout 上 的 
SurfaceView， 然 后 设置 SurfaceHolder 为 Layout SurfaceView。 有 具体 代码 如 下 : 


public void onCreate(Bundle savedInstanceState) 
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super.onCreate (savedInstanceState); 

setContentView (R.layout.main); 

/* 将 .3gp 图 像 文件 存放 URL 网 址 */ 

strVideoURL = 

"http://new4.sz.3gp2.com//20100205xyy/ 喜 羊 羊 与 灰太狼 $20 踩 高 跷 
(www.3gp2.com) .3gp"; 

/ /http://www.dubblogs.cc:8751/Android/Test/Media/3gp/test2.3gp 


mTextViewOl = (TextView)findViewById(R.id.myTextViewl); 
mEditText01 (EditText) findViewById (R.id.myEditText1); 
mEditText01.setText (strVideoURL); 


/* E Layout 上 的 SurfaceView */ 
mSurfaceView01 = (SurfaceView) findViewById(R.id.mSurfaceViewl) ; 


/* 设置 PixnelFormat */ 

getWindow() .setFormat (PixelFormat . TRANSPARENT) ; 
/* WE SurfaceHolder Jj Layout SurfaceView */ 
mSurfaceHolder01 = msSurfaceView0l.getHolder(); 
mSurfaceHolder01.addCallback (this); 


(3) 为 影片 设置 大 小 比例 ， 并 分 别 设 置 mPlay. mReset, mPause 和 mStop 四 个 控制 按 
钮 。 具 体 代 码 如 下 : 


/* 由 于 原 有 的 影片 Size 较 小 ， 故 指定 其 为 固定 比例 */ 
mSurfaceHolder01l.setFixedSize(160, 128); 
mSurfaceHolder01l.setType(SurfaceHolder.SURFACE TYPE PUSH BUFFERS); 
mPlay = (ImageButton) findViewById(R.id.play); 

mReset = (ImageButton) findViewById(R.id.reset); 

mPause = (ImageButton) findViewById(R.id.pause) ; 

mStop = (ImageButton) findViewById(R.id.stop); 


(4) 编写 单 击 “ 播 放 ” 按 钮 的 处 理事 件 ， 具 体 代码 如 下 : 
/* 播放 按钮 */ 


mPlay.setOnClickListener(new ImageButton.OnClickListener () 
{ 
public void onClick(View view) 
{ 
if (checkSDCard()) 
t 
strVideoURL = mEditText0l.getText ().toString(); 
playVideo (strVideoURL); 
mTextView01.setText (R.string.str play); 
b 
else 


t 
mTextView01.setText (R.string.str err nosd); 
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(5) 编写 单 击 “ 重 播 ”按钮 的 处 理事 件 ， 具 体 代码 如 下 : 
/* 重新 播放 按钮 */ 


mReset.setOnClickListener(new ImageButton.OnClickListener () 
{ 
public void onClick(View view) 
{ 
if (checkSDCard()) 
{ 
if(bIsReleased == false) 
{ 
if (mMediaPlayer01 != null) 
t 
mMediaPlayer01.seekTo (0); 
mTextViewOl.setText(R.string.str play); 


) 


} 
else 
{ 
mTextViewOl.setText(R.string.str err nosd); 


) 


We 
(6) 编写 单 击 “ 和 暂停 ”按钮 的 处 理事 件 ， 具 体 代码 如 下 : 
/* 暂停 按钮 */ 


mPause.setOnClickListener(new ImageButton.OnClickListener () 
{ 
public void onClick(View view) 
{ 
if (checkSDCard()) 
{ 
if (mMediaPlayer01 != null) 
t 
if(bIsReleased == false) 
t 

if (bIsPaused--false) 

t 
mMediaPlayer01.pause(); 
bIsPaused - true; 
mTextView01.setText (R.string.str pause); 

} 

else if(bIsPaused--true) 

t 
mMediaPlayer0l.start(); 
bIsPaused - false; 
mTextView0l.setText(R.string.str play); 
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} 
else 


{ 
mTextView01.setText (R.string.str err nosd); 


} 


be 
(7) 编写 单 击 “ 停 止 ”按钮 的 处 理事 件 ， 具 体 代码 如 下 : 
/* 停止 按钮 */ 


mStop.setOnClickListener(new ImageButton.OnClickListener () 
{ 
public void onClick(View view) 
{ 
if (checkSDCard()) 
t 
try 
t 
if (mMediaPlayer0l != null) 
t 
if (bIsReleased--false) 
di 
mMediaPlayer01.seekTo (0); 
mMediaPlayer01.pause(); 
mTextView0l.setText(R.string.str stop); 
b 
b 
} 
catch (Exception e) 
{ 
mTextView01.setText (e.toString()); 
Log.e (TAG, e.toString()); 
e.printStackTrace(); 
} 
} 
eise 
t 
mTextView01.setText (R.string.str err nosd); 


} 
}); 
} 
(8) 定义 方法 playVideo 来 下 载 指定 URL 地 址 的 影片 ， 并 在 下 载 后 进行 播放 处 理 。 具 
体 代码 如 下 : 


/* 自 定义 下 载 URL 影片 并 播放 */ 
private void playVideo(final String strPath) 
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/* 车 传 入 的 strPath 为 现 有 播放 的 连接 ， 则 直接 播放 */ 
if (strPath.equals(currentFilePath) && mMediaPlayer01 != null) 
t 
mMediaPlayer0l.start(); 
return; 
} 
else if (mMediaPlayer0l != null) 
{ 
mMediaPlayer01.stop(); 
} 
currentFilePath = strPath; 
/* BRM MediaPlayer WR*/ 
mMediaPlayer01 = new MediaPlayer (); 
/* 设置 播放 音量 */ 
mMediaPlayer01.setAudioStreamType (2); 
/* 设置 显示 于 SurfaceHolder */ 
mMediaPlayer01.setDisplay (mSurfaceHolder01); 
mMediaPlayer01.setOnErrorListener 
(new MediaPlayer.OnErrorListener () 
{ 
@override 
public boolean onError (MediaPlayer mp, int what, int extra) 
{ 
// TODO Auto-generated method stub 
Log.i 
( 
TAG, 
"Error on Listener, what: " + what + "extra: " + extra 
Ne 
return false; 
} 
); 


(9) 定义 onBufferingUpdate 事件 来 监听 缓冲 进度 ， 具 体 代 码 如 下 : 


mMediaPlayer01.setOnBufferingUpdateListener 
(new MediaPlayer. OnBufferingUpdateListener () 
{ 
@override 
public void onBufferingUpdate (MediaPlayer mp, int percent) 
{ 
// TODO Auto-generated method stub 
Log.i 
( 
TAG, "Update buffer: " 十 
Integer.toString(percent) + "$" 
); 


he 
(10) 定义 方法 run0) 来 接收 连接 并 记录 线程 信息 。 先 在 运行 线程 时 调用 自 定义 函数 来 抓 
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取 文件 ， 当 下 载 完 后 调用 prepare 准备 动作 ， 当 有 异常 发 生 时 输出 错误 信息 。 其 具体 代码 
WF: 


Runnable r = new Runnable () 
t 
public void run() 
t 
try 
t 
/* 在 线程 运行 中 ， 调 用 自 定义 函数 抓 取 文件 */ 
setDataSource (strPath); 
/* 下 载 完 后 才 会 调用 prepare */ 
mMediaPlayer01l.prepare(); 
Log.i 
( 
TAG, "Duration: " + mMediaPlayer0l.getDuration() 
); 
mMediaPlayer01.start (); 
bIsReleased = false; 
} 
catch (Exception e) 
t 
Log.e(TAG, e.getMessage(), e); 
} 
} 
] 7 
new Thread(r).start(); 
) 
catch(Exception e) 
t 
if (mMediaPlayer01 != null) 
t 
mMediaPlayer01.stop(); 
mMediaPlayer01.release(); 
H 


j 
(11) 定义 方法 setDataSource 使 用 线程 启动 的 方式 来 播放 视频 ， 有 具体 代码 如 下 : 
/* 自 定义 setDatasource， 由 线程 启动 */ 


private void setDataSource(String strPath) throws Exception 
{ 
if (!URLUtil.isNetworkUrl (strPath) ) 
{ 
mMediaPlayer01.setDataSource (strPath) ; 
} 
else 


{ 
if (bIsReleased == false) 
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URL myURL = new URL(strPath); 
URLConnection conn = myURL.openConnection (); 
conn.connect () ; 
InputStream is = conn.getInputStream(); 
if (is == null) 
t 

throw new RuntimeException("stream is null"); 
} 
File myFileTemp = File.createTempFile 
("hippoplayertmp", "."«getFileExtension(strPath)); 


currentTempFilePath = myFileTemp.getAbsolutePath (); 
/*currentTempFilePath - /sdcard/mediaplayertmp39327.dat */ 


FileOutputStream fos = new FileOutputStream(myFileTemp) ; 
byte buf[] = new byte[128]; 
do 
t 

int numread - is.read(buf); 

if (numread «- 0) 

t 

break; 

} 

fos.write (buf, 0, numread); 
)while (true); 
mMediaPlayer01.setDataSource (currentTempFilePath); 
Ery 
t 

is.close(); 
} 
catch (Exception ex) 
{ 

Log.e(TAG, "error: " + ex.getMessage(), ex); 
H 


) 
(12) 定义 方法 getFileExtension 来 获取 视频 的 扩展 名 ， 具 体 代码 如 下 : 


private String getFileExtension(String strFileName) 

t 
File myFile - new File(strFileName); 
String strFileExtension-myFile.getName(); 
strFileExtension-(strFileExtension.substring 
(strFileExtension.lastIndexOf (".")+1)) .toLowerCase(); 


if (strFileExtension=="") 
{ 
/* 车 无 法 顺利 取得 扩展 名 ， 默 认为 .dat */ 


strFileExtension = "dat"; 
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return strFileExtension; 
) 


(13) 定义 方法 checkSDCard0 来 判断 存储 卡 是 否 存在 ， 有 具体 代码 如 下 : 


private boolean checkSDCard() 
{ 
/* 判断 存储 卡 是 否 存在 */ 
if(android.os.Environment.getExternalStorageState().equals 
(android.os.Environment.MEDIA MOUNTED) ) 
{ 
return true; 
} 
else 
{ 
return false; 


} 
@override 
public void surfaceChanged 
(SurfaceHolder surfaceholder, int format, int w, int h) 
{ 
Log.i(TAG, "Surface Changed") ; 
} 
public void surfaceCreated(SurfaceHolder surfaceholder) 
{ 
Log.i(TAG, "Surface Changed") ; 
5 


@override 
public void surfaceDestroyed(SurfaceHolder surfaceholder) 
{ 
Log.i(TAG, "Surface Changed") ; 
T 
) 


执行 后 在 文本 框 中 显示 指定 播放 视频 的 URL， 当 下 载 完 毕 后 能 够 实现 播放 处 理 ， 如 
图 11-7 所 示 。 


http://new4.sz.3gp2.com//20100205: 


61H50 


图 11-7. ”执行 效果 
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实例 中 的 MediaProvider 相当 于 一 个 数据 中 心 ， 在 里 面 记录 了 存储 卡 中 的 所 有 数据 ， 
而 Gallery 的 作用 就 是 展示 和 操作 这 个 数据 中 心 ， 每 次 用 户 启动 Gallery 时 ，Gallery 只 是 读 
取 MediaProvider 中 的 记录 并 显示 用 户 。 如 果 用 户 在 Gallery 中 删除 一 个 媒体 时 ，Gallery 
通过 调用 MediaProvider 开放 的 接口 来 实现 。 


11.8 在 Android 中 开发 一 个 网 络 收音 机 


相信 读者 在 自己 的 Android 手机 上 见 过 网 络 收音 机 ， 这 和 传统 的 用 天 线 来 接收 信号 的 
收音 机 不 同 ， 网 络 收音 机 是 通过 网 络 来 获取 收音 机 信号 的 。 本 节 将 详细 讲解 在 Android 系 
统 中 开发 网 络 收音 机 项 目的 基本 知识 。 


11.8.1 基本 思路 


由 于 很 多 网 络 广播 使 用 的 协议 是 来 自 微软 的 MMS， 但 是 Android 并 不 支持 这 种 流 媒 体 
协议 ， 读 者 可 以 尝试 使 用 “Vitamio 插件 +Vitamio 库 ” 的 方式 来 解决 。 这 样 在 安装 app 本 
身 的 APK 的 同时 还 要 安装 对 应 你 手机 的 Vitamio 插件 ， 这 个 插件 是 国外 程序 员 开 发 的 免费 
产品 ， 支 持 很 多 媒体 格式 ， 大 约 3MB。 这 个 插件 和 硬件 有 关 ， 读 者 在 下 载 时 可 以 一 个 一 个 
地 试 。 在 笔者 写作 本 书 时 ， 此 插件 已 有 如 下 4 个 版 本 。 

Q  ARMv6: for some low end devices (Market, VOV) 

Q VFP: for some low end devices with VFP support (Market, VOV) 

Q ARMv7: for ARMv7 devices without NEON support, such as Tegra 2 powered 

devices(Market, VOV) 

Q NEON: for ARMv7 devices with NEON support (Market, VOV) 

在 具体 开发 之 前 ， 最 好 在 Vitamio 插件 官网 上 下 载 API 的 使 用 文档 Vitamio-SDK.7z.« 
在 这 个 SDK 里 面 还 有 一 个 名 为 vitamio.jar 的 jar 文件， 里面 有 流 媒体 的 控制 类 。 


11.8.2 ”演示 代码 


了 解 了 开发 Android 网 络 收音 机 的 思路 ， 并 准备 好 “Vitamio 插件 +Vitamio 库 ” 后 ， 
下 面 通过 具体 的 演示 代码 来 展示 开发 流程 。 
(1) AndroidManifest 文件 的 演示 代码 如 下 : 


<?xml version-"1.0" encoding-"utf-8"?» 
«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package-"com.netradiodemo" 
android:versionCode-"1" 
android:versionName-"1.0"» 
«uses-sdk android:minSdkVersion-"10" /> 
«uses-permission android:name-"android.permission.INTERNET"»«/uses- 
permission» 


«application android:icon="@drawable/icon" android:label- 
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"@string/app name" 
android: theme="@android:style/Theme.Black"> 
«activity android:name-".NetRadioDemoActivity" 
android: label="@string/app name"> 
<intent-filter> 
<action android:name="android.intent.action.MAIN" /> 
<category android:name="android.intent.category. LAUNCHER" /> 
</intent-filter> 
</activity> 
<activity android:name=".compnents.PlayerActivity"></activity> 
</application> 
</manifest> 


(2) UI 主 页面 布局 文件 main 不 用 做 任何 修改 ， 播 放 页 面 布 局 文件 play_page.xml W F: 


<?xml version-"1.0" encoding-"utf-8"?» 

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation-"vertical" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
> 

<Button 
android:id="@+id/btn start" 
android:layout gravity="center horizontal" 
android:layout width="match parent" 
android:layout height-"wrap content" 
android:text=" 听 猫扑 " 
android:textSize-"30sp" 
android:onClick="doStart" 
/> 
<Button 
android:id="@+id/btn stop" 
android:layout gravity="center horizontal" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:text=" 不 听 猫 扑 " 
android:textSize-"30sp" 
android:onClick-"doStop" 
/> 

</LinearLayout> 


(3) 实现 第 一 个 Activity 代码 ， 功 能 是 检查 插件 Ne 了 RadioDemoActivity， 代 码 如 下 : 


package com.netradiodemo; 


import io.vov.vitamio.VitamioInstaller; 

import io.vov.vitamio.VitamioInstaller.VitamioNotCompatibleException; 
import io.vov.vitamio.VitamioInstaller.VitamioNotFoundException; 
import android.app.Activity; 

import android.content.Intent; 

import android.os.Bundle; 

import android.util.Log; 
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import android.view.View; 

import android.view.View.OnClickListener; 

import android.widget.Button; 

import android.widget.LinearLayout.LayoutParams; 
import android.widget.TextView; 

import android.widget.Toast; 

import com.netradiodemo.compnents.PlayerActivity; 


public class NetRadioDemoActivity extends Activity ( 

Intent intent ; 

GOverride 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView(R.layout.main); 
intent = new Intent(this, PlayerActivity.class); 
TextView tvCheck = new TextView (this); 
tvCheck.setText (" 使 用 前 请 检查 是 否 安装 了 Vitamio 插件 :") ; 
this.addContentView(tvCheck, new LayoutParams (LayoutParams.MATCH PARENT, 

LayoutParams.WRAP CONTENT)); 


Button btnCheck = new Button (this); 
btnCheck.setText (" 检 查 ") ; 
btnCheck.setOnClickListener(new OnClickListener() ( 
GOverride 
public void onClick(View arg0) ( 
try ( 
String isInstallerString - VitamioInstaller 
.checkVitamioInstallation (NetRadioDemoActivity.this); 
// 检 查 插件 是 否 安 装 成 功 ， 这 里 是 一 个 费时 操作 ， 应 该 启用 线程 处 理 ， 作 为 一 个 demo 我 就 不 做 了 
Log.i("tag",isInstallerString); 
// 插 件 安装 成 功 后 ，Log 中 显示 插件 名 称 
if(isInstallerString!-null)( 
Toast .makeText (NetRadioDemoActivity.this, "已 安装 
正确 版 本 Vitamio!", Toast.LENGTH LONG).show(); 
startActivity (intent);// 开 启 收听 界面 
Jelse( 
Toast.makeText (NetRadioDemoActivity.this, "没有 匹配 的 
Vitamio!", Toast.LENGTH LONG).show(); 
finish() ;// 没 有 插件 ， 安 装 失败 ， 则 结束 程序 


iE 

} catch (VitamioNotCompatibleException e) { 
e.printStackTrace(); 

) catch (VitamioNotFoundException e) ( 
e.printStackTrace(); 


}); 
this.addContentView (btnCheck, new LayoutParams (LayoutParams.WRAP CONTENT, 
LayoutParams.WRAP CONTENT) ) ; 
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(4) 实现 第 二 个 Activity， 主 要 负责 播放 PlayerActivity， 代 码 如 下 : 


package com.netradiodemo.compnents; 


import 
import 
import 
import 
import 
import 
import 
import 
import 


import 


public 


io.vov.vitamio.MediaPlayer; 
io.vov.vitamio.VitamioInstaller.VitamioNotCompatibleException; 
io.vov.vitamio.VitamioInstaller.VitamioNotFoundException; 
io.vov.vitamio.widget.MediaController; 

java.io.IOException; 

android.app.Activity; 

android.os.Bundle; 

android.view.View; 

android.widget.LinearLayout.LayoutParams; 


com.netradiodemo.R; 


class PlayerActivity extends Activity ( 


MediaPlayer mPlayer; 
GOverride 
protected void onCreate(Bundle savedInstanceState) ( 


} 


setContentView(R.layout.play page); 


MediaController controller = new MediaController (this) ;// 创 建 控制 对 象 


this.addContentView(controller, new LayoutParams 
(LayoutParams.WRAP CONTENT, LayoutParams.WRAP CONTENT)); 

String path - "mms://ting.mop.com/mopradio"; 
// 猫 扑 电 台地 址 ， 这 里 可 以 添加 自己 的 喜欢 的 电台 地 址 ，mms 协议 的 

try { 
mPlayer = new MediaPlayer(this); // 播 放流 媒体 的 对 象 
mPlayer.setDataSource (path); // 设 置 流 媒体 的 数据 源 
mPlayer.prepare(); 

) catch (VitamioNotCompatibleException e) ( 
e.printStackTrace(); 

) catch (VitamioNotFoundException e) { 
e.printStackTrace(); 

) catch (IllegalArgumentException e) ( 
e.printStackTrace(); 

) catch (IllegalStateException e) ( 
e.printStackTrace(); 

) catch (IOException e) ( 
e.printStackTrace(); 

} 

super .onCreate (savedInstanceState) ; 


public void doStart (View view) { 


} 


mPlayer.start () ;// 开 始 播放 


public void doStop(View view) { 


} 


mPlayer. stop () ;// 停 止 播放 


通过 上 述 编码 操作 之 后 ， 运 行 后 就 可 以 收听 猫扑 电台 的 音乐 了 。 
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微 博 ， 即 微 博客 (MicroBlog) 的 简称 ， 是 一 个 基于 用 户 关 系 
的 信息 分 享 、 传 播 以 及 获取 平台 ， 用 户 可 以 通过 Web. WAP 
以 及 各 种 客户 端 组 件 个 人 社区 ， 以 140 字 左 右 的 文字 更 新 信 
息 ， 并 实现 即时 分 享 。 本 章 将 详细 介绍 在 Android 系统 中 开发 
微 博 项 目的 基本 知识 。 
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在 互联 网 时 代 ， 使 用 博客 的 人 越 来 越 多 ， 人 们 通过 博客 抒发 情感 、 编 写 日 记 、 记 录 生 
活 中 的 点 点 滴 滴 ， 更 有 许多 部 落 客 ， 通 过 博客 来 分 享 不 同 领域 的 生活 。 为 了 方便 人 们 的 生 
活 ， 在 很 多 智能 手机 上 推出 了 “移动 博客 发 布 器 ”。 

最 早 也 是 最 著名 的 微 博 是 美国 的 twitter， 根 据 相 关公 开 数据 ， 截 至 2010 年 1 月 份 ， 该 
产品 在 全 球 已 经 拥有 7500 万 注册 用 户 。2009 年 8 月 份 中 国 最 大 的 门户 网 站 新 浪 网 推出 
“新 浪 微 博 ” 内 测 版 ， 成 为 门户 网 站 中 第 一 家 提供 微 博 服 务 的 网 站 ， 微 博 正 式 进 入 中 文 上 
网 主流 人 群 视野 。 

1. 微 博 的 特点 

微 博客 草根 性 更 强 ， 且 广泛 分 布 在 桌面 、 浏 览 器 、 移 动 终端 等 多 个 平台 上 ， 有 多 种 商 
业 模 式 并 存 ， 或 形成 多 个 垂直 细 分 领域 的 可 能 ， 但 无 论 哪 种 商业 模式 ， 都 离 不 开 用 户 体验 
的 特性 和 基本 功能 。 

2. 手机 微 博 

微 博 的 主要 发 展 运 用 平台 应 该 是 以 手机 用 户 为 主 ， 微 博 以 电脑 为 服务 器 以 手机 为 平 
台 ， 把 每 个 手机 用 户 用 无 线 的 手机 连 在 一 起 ， 让 每 个 手机 用 户 不 用 使 用 电脑 就 可 以 发 表 自 
己 的 最 新 信息 ， 并 和 好 友 分 享 自己 的 快乐 。 

微 博之 所 以 要 限定 140 个 字符 ， 就 是 源 于 从 手机 发 短信 最 多 字符 140 个 ( 微 博 进入 中 国 
后 普遍 默认 为 140 个 汉字 ， 随 心 微 博 333 字 )。 可 见 微 博 从 诞生 之 初 就 同 手机 应 用 密 不 可 
分 ， 更 是 其 在 互联 网 形态 中 最 大 的 亮点 。 微 博 对 互联 网 的 重大 意义 就 在 于 建立 手机 和 互联 
网 应 用 的 无 颖 连接 ， 培 养 手机 用 户 使 用 手机 上 网 的 习惯 ， 增 强手 机 端 同 互联 网 端的 互动 ， 
从 而 使 手机 用 户 顺利 过 渡 到 无 线 互联 网 用 户 。 目 前 手机 和 微 博 应 用 的 结合 有 以 下 三 种 形式 。 

(1) 通过 短信 和 彩信 。 

短信 和 彩信 形式 是 同 移动 运营 商 合 作 ， 用 户 所 花 的 短信 和 彩信 费用 由 运营 商 收取 ， 这 
种 形式 覆盖 的 人 群 比较 广泛 ， 只 要 能 发 短信 就 能 更 新 微 博 ， 但 对 用 户 来 说 更 新 成 本 太 大 ， 
并 且 彩 信 限 制 SOKB 的 浆 端 严重 影响 了 所 发 图 片 的 清晰 度 。 最 关键 的 是 这 个 方法 只 能 提供 
更 新 ， 而 无 法 看 到 其 他 人 的 更 新 ， 这 种 单 向 的 信息 传输 方式 大 大 降低 了 用 户 的 参与 性 和 互 
动 性 ， 让 手机 用 户 只 体验 到 一 个 半 吊 子 的 微 博 。 

(2) 通过 WAP 版 网 站 。 

各 微 博 网 站 基本 都 有 自己 的 WAP 版 ， 用 户 可 以 通过 登录 WAP 或 安装 客户 端 连接 到 
WAP 版 。 这 种 形式 只 要 手机 能 上 网 就 能 连接 到 微 博 ， 可 以 更 新 也 可 以 浏览 、 回 复 和 评 
论 ， 所 需 费用 就 是 浏览 过 程 中 使 用 的 流量 费 。 但 目前 国内 的 GPRS 流量 费 还 相对 较 高 ， 网 
速 也 相对 较 慢 ， 如 果 要 上 传 大 容量 的 图 片 ， 速 度 非常 慢 。 

(3) 通过 手机 客户 端 。 

手机 客户 端 分 以 下 两 种 。 
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QD 微 博 网 站 开发 的 基于 WAP 的 快捷 方式 版 。 

用 户 通过 客户 端 直接 连接 到 经 过 美化 和 优化 的 WAP 版 微 博 网 站 。 这 种 形式 用 户 行为 
主要 靠 主 动 来 实现 ， 也 就 是 用 户 在 想起 更 新 和 浏览 微 博 的 时 候 才 打开 客户 端 ， 其 实 也 就 相 
当 于 在 手机 端 增加 了 一 个 微 博 网 站 快捷 方式 ， 使 用 操作 上 的 利 浆 和 WAP 网 站 也 基本 相同 。 

© 利用 微 博 网 站 提供 的 API 开发 的 第 三 方 客户 端 。 

这 种 客户 端 在 国内 还 比较 少 ， 国 际 上 比较 有 名 的 是 twitter 的 客户 端 Gravity 和 
Hesine( 和 信 )。Gravity 是 专门 为 twitter 开发 的 ， 需 要 通过 主动 联网 登录 的 ， 但 操作 架构 和 
界面 经 过 合理 设计 ， 用 户 体 验 非常 好 ， 可 惜 目前 只 支持 S60 系统 。Hesine 是 国内 公司 开发 
的 ， 目 前 不 但 支持 twitter， 还 支持 国内 的 各 主流 微 博 。 与 其 他 客户 端 不 同 的 是 ，Hesine 的 
客户 端 是 利用 IP Push 技术 提供 微 博 更 新 和 下 发 通道 ， 不 但 能 够 大 大 提升 用 户 更 新 微 博 的 
速度 ， 更 重要 的 是 能 将 微 博 消 息 推送 到 用 户 的 手机 ， 用 户 不 用 主动 登录 微 博 就 能 浏览 和 互 
动 。Hesine 支持 的 系统 平台 比较 多 ， 但 缺点 是 在 非 智能 机 上 的 体验 还 不 够 好 。 

相对 于 短信 和 彩信 以 及 WAP 形式 ， 客 户 端的 形式 更 符合 无 线 互 联网 的 发 展 趋势 。 尽 
管 目前 手机 系统 平台 比较 复杂 ， 客 户 端 开发 起 来 难度 很 大 ， 并 且 各 客户 端 在 非 智能 机 上 的 
发 挥 和 体验 整体 都 不 佳 ， 但 是 随 着 智能 机 逐渐 平民 化 ， 无 线 网 络 速度 的 提升 和 流量 资费 的 
下 调 ， 手 机 和 微 博 的 结合 肯定 越 来 越 密切 ， 当 山寨 手机 都 能 尽情 地 玩 转 微 博 的 时 候 ， 相 信 
那 时 候 的 微 博 会 为 互联 网 和 3G 应 用 带 来 很 多 革命 性 的 变化 。 


12.2 ” 微 博 开发 技术 介绍 


本 节 将 简单 介绍 在 Android 平台 开发 微 博 系统 所 需要 的 技术 。 
12.2.1 XML-RPC 技 术 


开发 移动 微 博 的 关键 技术 是 RPC. RPC 是 Remote Procedure Call 的 缩写 ， 意 为 “远程 
过 程 调 用 ”。XML-RPC 是 一 种 统一 标准 的 规范 ， 是 通过 HTTP 连接 的 方式 运行 的 ， 以 传 
送 符合 XML-RPC 格式 的 Request 来 调用 远程 服务 器 上 的 某 个 程序 ， 进 而 运行 博客 功能 。 
许多 的 网 络 服务 业 都 会 以 XML-RPC 方式 提供 给 软件 开发 者 一 个 系统 连接 的 管道 ， 让 开发 
者 能 够 根据 业者 定义 好 的 方式 ， 以 XML-RPC 的 方式 来 使 用 该 网 站 的 某 些 功能 。 目 前 许多 
的 博客 也 都 支持 XML-RPC 的 连接 方式 。 

XML-RPC 的 原理 是 ，XML-RPC 工具 把 传 入 的 参数 组 合成 XML， 然后 通过 HTTP D 
议 发 送 给 服务 器 ， 服 务 器 回复 XML 格式 数据 ， 再 由 工具 解析 给 调用 者 。 

在 XML-RPC 标准 中 ， 规 定 XML 内 容 的 规则 如 下 : 

«xml version-"1.0"?» 

<methodCall> 

<methodName> 要 调用 的 method name</methodName> 
<params> 


<params> 参 数 1</param> 
<params> 参 数 2</param> 


> Andid sssanAnsmia 


<param> n</param> 


</params> 
«/methodCall» 
Android 本 身 并 不 支持 XML-RPC 协议 ， 需 要 下 载 相应 的 工具 。 读 者 可 以 从 如 下 地 址 
下 载 XML-RPC: 


http://code.google.com/p/android-xmlrpc/downloads/list 
例如 下 面 的 代码 演示 了 用 XML-RPC 协议 实现 微 博客 户 端的 基本 过 程 。 


package org.xmlrpc; 


import java.net.URI; 

import java.util.HashMap; 

import java.util.Map; 

import org.apache.http.conn.HttpHostConnectException; 
import org.xmlrpc.android.XMLRPCClient; 

import org.xmlrpc.android.XMLRPCException; 

import org.xmlrpc.android.XMLRPCFault; 

import org.xmlrpc.android.XMLRPCSerializable; 

import android.app.Activity; 

import android.content.Context; 

import android.os.Bundle; 

import android.util.Log; 

import android.widget.EditText; 

import android.widget.Toast; 

import android.widget.Button; 

import android.content.DialogInterface.OnCancelListener; 
import android.view.View.OnClickListener; 

import android.view.View; 


public class TestBlog extends Activity ( 
private XMLRPCClient client; 
private URI uri; 


@override 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 


setContentView(R.layout.test blog); 

Button btn = (Button) findViewById (R.id.send); 
btn.setOnClickListener (new OnClickListener() { 
public void onClick(View v) ( 

post (); 


he 
void post() { 


String blogid = ((EditText) findViewById(R.id.blogid edit)) .getText () 
-toString(); //1D S 
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String username = ((EditText) findViewById(R.id.username edit)) 
-getText().toString();  // 用 户 名 
String password = ((EditText) findViewById(R.id.password edit)) 
.getText().toString(); // 密码 
String title = ((EditText) findViewById(R.id.title edit)).getText () 
-toString(); // 标 题 
String content = ((EditText) findViewById(R.id.content edit)) 
.getText() 
-toString (); JE 六 
uri = URI.create("http://blog.csdn.net/" + blogid 
+ "/services/metablogapi.aspx"); 
client = new XMLRPCClient (uri); 


Map<String, Object» structx = new HashMap<String, Object>(); 

structx.put("title", title); 

structx.put ("description", content); 

Object[] params - new Object[] ( blogid, username, password, 
structx, true ); 


try ( 
client.callEx("metaWeblog.newPost", params); 
Toast.makeText (this, "OK", 10000).show(); 
) catch (XMLRPCException e) ( 
Toast.makeText (this, "ERROR" + e, 10000).show(); 


12.22 Meta Weblog APIS Fit 


Meta Weblog API 是 博客 园 发 布 的 一 款 功 能 强大 的 客户 端 ， 其 登录 地 址 是 
http://www.cnblogs.com/< 您 的 用 户 名 >/services/metaweblog.aspx。Meta Weblog API 支持 通 
过 XML-RPC 的 方法 在 软件 中 编辑 及 浏览 Blog， 其 常用 的 API 如 下 。 

口 ” 发布 新 文章 (metaWeblog.newPost) 
获取 分 类 (metaWeblog.getCategories) 

最 新 文章 (metaWeblog.getRecentPosts) 
新 建文 章 分 类 (wp.newCategory) 
上 传 图 片 音 频 或 视频 (metaWeblog.newMediaObject) 


日 = | 


12.3 在 Android 上 开发 移动 博客 发 布 器 


在 本 实例 中 实现 了 一 个 “移动 博客 发 布 器 ”的 功能 ， 以 乐 多 博客 为 例 ， 演 示 了 如 何 从 
手机 发 布 文章 到 乐 多 博客 上 的 方法 。 
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x i Ij 能 源码 路 径 
实例 12-1 开发 一 个 移动 微 博 发 布 系统 下 载 路 径 :\daima\12\weib 


12.3.1 XML 请 求 


调用 乐 多 博客 的 metaWeblog newPost 接口 实现 添加 博客 文章 的 功能 ， 发 出 的 XML 请 
求 内 容 如 下 : 


< ?xml version="1.0"2?> 
«methodCall» 
«methodN ame »metaWeblog.newPost«/methodName» 
<params> 
<param><value><st ring>ID</string></value></param> 
<param><value><string>ik's</string></value></param> 
<param><value><string>#f4</string></value></param> 
<param> 
<value> 
<struct> 
<member> 
<name>title</name> 
<value><string> 文 章 标题 </string></value> 
«/member» 
«member» 
«name»descriptiori«/name» 
<value><string> 内 容 </string></value> 
</member> 
</struct> 
</value> 
</param> 
<param><value><boolean>1</boolean></value></param> 
</params> 
«/methodCall» 


12.3.2 ”常用 接口 


并 非 所 有 的 博客 都 可 以 用 Get 或 Post 方式 实现 XML-RPC 的 Request 交互 ， 有 些 博 客 
只 能 以 Post 的 方式 来 传送 。 所 以 在 具体 编码 之 前 ， 要 先 弄 清楚 服务 器 接收 Request 是 否 有 
特殊 限制 。 在 乐 多 博客 的 项 目 中 ， 为 开发 人 员 提 供 了 许多 交互 方法 ， 通 过 这 些 方法 可 以 实 
现 包罗 万 象 的 功能 ， 在 表 12-1 中 列 出 了 几 种 常用 的 方法 。 


表 12-1 常用 的 方法 接口 


方法 名 称 SB 5 返回 值 说 AA 
博客 ID(string) 


usemame(string) 


Weblog newP d(string) BO ED D. gra 
metaWeblog.newPost 'assword(s! T — Je "n 
E : à 失败 :fault 


content 
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续 表 
方法 名 称 参 数 说 明 
文章 ID(string) 
usemame(string) 
metaWeblog.editPost password(string) 修改 已 发 布 的 文章 内 容 
content 
publish(boolean) 
文章 ID(string) 
metaWeblog.getPost usemame(string) 取得 特定 文章 的 信息 
password(string) 
博客 ID(string) 
metaWeblog. isematme(striñg) 成 功 : 文章 数组 返回 最 近 发 表 的 文章 信息 
getRecentPosts password(string) 失败 : fault 
返回 篇 数 (int) 
ea 成 功 : 
metaWeblog.deletePost | usemame(string) 失败 ; 删除 已 发 布 的 博客 文章 
password(string) 
博客 ID(strin 
mt.getCategoryList uu oe 取得 博客 的 文章 分 类 信息 
失败 : fault 
password(string 
文章 ID(string) "m 
mt.getPostCategories usemame(string) 失败 ， 返回 指定 文章 的 所 属 类 信息 
password(string 
文章 ID(string) 
mt.setPostCategories —Ó— ig 设置 指定 文章 所 在 的 类 
password(string) 失败 : 
文章 分 类 (数组 ) 
mt.supportedMethods : 方法 数组 kie : ei EEC 


12.3.3 ”具体 实现 


在 本 实例 中 ， 以 EditText 编辑 框 作为 输入 博客 相关 信息 及 文章 内 容 的 组 件 ， 当 用 户 输 
入 完成 后 单 击 “ 发 布 文章 ”按钮 ， 此 Button 按钮 的 onClick0 会 被 触发 ， 首 先 检查 输入 字段 
是 否 为 空白 ， 检 查 无 误 后 ， 程 序 先 运行 getPostString0， 将 输入 参数 转换 成 符合 XML-RPC 
规范 的 XML 格式 ， 再 调用 sendPost()# XML 的 Request 传送 给 相对 应 的 博客 网 址 ， 最 后 
再 取得 服务 器 返回 的 Response， 并 使 用 对 话 框 形式 显示 运行 结果 。 


本 实例 的 具体 实现 流程 如 下 。 
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(1) 编写 布局 文件 main.xml， 主 要 代码 如 下 : 


<TextView 
android: id="@+id/myText1" 
android:layout width="wrap content" 
android: layout height-"23px" 
android:text="@string/str titlel" 
android: textColor="@drawable/black" 
android:layout x-"l0px" 
android:layout y-"22px" 

> 

</TextView> 

<TextView 
android: id="@+id/myText2" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:text="@string/str title2" 
android: textColor="@drawable/black" 
android:layout x="10px" 
android:layout y="62px" 

> 

</TextView> 

<TextView 
android: id="@+id/myText3" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:text="@string/str title3" 
android: textColor="@drawable/black" 
android: layout_x="10px" 
android:layout y-"102px" 

ew 

«/TextView» 

«TextView 
android: id="@+id/myText4" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:text="@string/str title4" 
android: textColor="@drawable/black" 
android:layout x-"l0px" 
android:layout y-"142px" 

> 

«/TextView» 

«TextView 
android: id="@+id/myText5" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:text="@string/str title5" 
android: textColor="@drawable/black" 
android:layout x="10px" 
android:layout y="182px" 


«/TextView» 

«EditText 
android: id="@+id/blogId" 
android:layout width="100px" 
android: layout_height="40px" 
android:numeric-"integer" 
android:layout x-"90px" 
android:layout y="12px" 

> 

«/EditText» 

<EditText 
android: id="@+id/blogAccount" 
android:layout width="170px" 
android:layout height="40px" 
android: textSize="16sp" 
android:layout x="90px" 
android:layout y="52px" 

E 

«/EditText» 

<EditText 
android: id="@+id/blogPwa" 
android:layout width="170px" 
android: layout height="40px" 
android: textSize="16sp" 
android: password="true" 
android:layout x="90px" 
android:layout y="92px" 

> 

</EditText> 

<EditText 
android:id="@+id/artContent" 
android:layout width-"210px" 
android:layout height-"207px" 
android:textSize-"l6sp" 
android:layout x-"90px" 
android:layout y-"172px" 

D 

«/EditText» 

<EditText 
android: id="@+id/artTitle" 
android:layout width="200px" 
android: layout height="40px" 
android: textSize="16sp" 
android:layout x="90px" 
android:layout y="132px" 
android: scrollbars="vertical" 


= 

</EditText> 

<Button 
android:id="@+id/myButton" 
android:layout_width=" 90px" 
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android:layout height="40px" 
android:text="@string/str button" 
android:textSize="16sp" 
android:layout x="120px" 
android: layout_y="382px" 

> 

</Button> 


(2) 编写 界面 显示 文本 文件 strings.xml， 主 要 代码 如 下 : 


<resources> 
<string name="hello"></string> 
<string name="app name"></string> 
«string name-"str titlel">ID 号 是 : «/string» 
«string name-"str title2"> 登 录 账 号 ; </string> 
«string name="str title3"> 登 录 密码 : </string> 
«string name="str title4"> 文 章 标题 </string> 
«string name="str title5"> 文 章 内 容 ; </string> 
«string name="str button"> 发 布 文章 </string> 
</resources> 


(3) 编写 主 程序 文件 weib.java， 主 要 代码 如 下 : 


public class weib extends Activity 
{ 
/* 变量 声明 */ 
Button mButton; 
EditText mEditl; 
EditText mEdit2; 
EditText mEdit3; 
EditText mEdit4; 
EditText mEdit5; 
/* 乐 多 博客 XML-RPC 网 址 */ 
private String path- 
" http: //blog.csdn.net/asdfg343442"; 
/* XML-RPC 发 布 文章 的 method name */ 
private String method-"metaWeblog.newPost"; 


@override 

public void onCreate (Bundle savedInstanceState) 

{ 
super .onCreate (savedInstanceState); 
setContentView (R.layout.main); 
/* 初始 化 对 象 */ 
mEditl- (EditText)findViewById (R.id.blogId); 
mEdit2- (EditText) findViewById (R.id.blogAccount); 
mEdit3- (EditText) findViewById (R.id.blogPwd); 
mEdit4- (EditText) findViewById (R.id.artTitle); 
mEdit5- (EditText) findViewById (R.id.artContent); 
mButton- (Button) findViewById (R.id.myButton); 
/* 设置 发 布 文章 的 onclick 事件 */ 


mButton.setOnClickListener (new View.OnClickListener () 
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t 

public void onClick(View v) 

t 
/* 取得 输入 的 信息 */ 
String blogId-mEditl.getText().toString(); 
String account=mEdit2.getText () .toString(); 
String pwd-mEdit3.getText().toString(); 
String title=mEdit4.getText ().toString(); 
String content=mEdit5.getText () .toString(); 


if (blogId.equals("") | |account.equals("") | |pwd.equals("") | | 
title.equals("") | |content.equals("") ) 
{ 
showDialog ("没有 填写 内 容 !"); 
} 
else 
t 
/* RIÉ XML Post 并 显示 Response 内 容 */ 
String outS=getPostString (method, blogId, account, 
pwd, title, content) ; 
String re=sendPost (outs) ; 
showDialog (re); 
} 


); 
} 


/* RIÉ Request 至 博客 的 对 应 网 址 的 method */ 
private String sendPost (String outstring) 
{ 
HttpURLConnection conn-null; 
String result-" 
URL url - null; 
try 
t 
url - new URL(path); 
conn = (HttpURLConnection)url.openConnection(); 
/* 允许 Input. Output */ 
conn.setDoInput (true); 
conn.setDoOutput (true); 
/* 设置 传送 的 method=POST */ 
conn.setRequestMethod ("POST"); 
/* setRequestProperty */ 
conn.setRequestProperty("Content-Type", "text/xml"); 
conn.setRequestProperty ("Charset", "UTF-8"); 


/* 送出 Request */ 
OutputstreamWriter out = 
new OutputStreamWriter(conn.getOutputStream(), "utf-8"); 
out.write(outString); 
out.flush(); 
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out.close(); 
/* 解析 返回 的 XML 内 容 */ 
result-parseXML (conn.getInputStream()); 
conn.disconnect () 7 

} 

catch (Exception e) 

{ 
conn.disconnect () ; 
e.printStackTrace(); 
showDialog (""+e); 

} 

return result; 

) 


/* fitr Response 的 XML EI] method */ 
private String parseXML (InputStream is) 
t 
String result-""; 
Document doc - null; 
try 
t 
/* 将 XML 转换 成 Document WE */ 
DocumentBuilderFactory dbf- 
DocumentBuilderFactory.newInstance(); 
DocumentBuilder db-dbf.newDocumentBuilder () ; 
doc = db.parse(is); 
doc.getDocumentElement () .normalize(); 
/* 检查 返回 值 是 否 有 包含 fault 这 个 tag， 如 果 有 就 代表 发 布 错误 */ 
int fault=doc.getElementsByTagName ("fault").getLength(); 
if (fault>0) 
{ 
result+=" 发 布 错 误 !\n"; 
/* 取得 faultcode (错误 代码 ) */ 
NodeList nListl=doc.getElementsByTagName ("int"); 
for (int i = 0; i < nListl.getLength(); ++i) 
t 
String errCode-nListl.item(i).getChildNodes().item(0) 
-getNodeValue(); 
result+=" 错 误 代 码 : "+errCode+"\n"; 
} 
/* 取得 faultstring (错误 信息 ) */ 
NodeList nList2=doc.getElementsByTagName ("string"); 
for (int i = 0; i < nList2.getLength(); ++i) 
{ 
String errString-nList2.item(i).getChildNodes () .item(0) 
-getNodeValue (); 
result+=" 错 误 信息 : "+errstring+"\n"; 
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/* 发 布 成 功 ， 取 得 文章 编号 */ 
NodeList nList-doc.getElementsByTagName ("string"); 
for (int i = 0; i < nList.getLength(); ++i) 
t 

String artId-nList.item(i).getChildNodes ().item(0) 

-getNodeValue(); 
result+=" 发 布 成 功 ! ! 文 章 编号 ["+artId+"] "; 


} 
catch (Exception ioe) 
t 
showDialog(""+ioe) ; 
5 
return result; 
} 


/* 一 组 要 发 送 的 XML 内 容 的 method */ 
private String getPostString(String method,String blogId, 
String account,String pwd,String title,String content) 


String s-""; 

s+="<methodCall>"; 

s+="<methodName>"+method+"</methodName>"; 

S+="<params>"; 

s+="<param><value><string>"+blogId+"</string></value></param>"; 

s+="<param><value><string>"+account+"</string></value></param>"; 

s+="<param><value><string>"+pwd+"</string></value></param>"; 

s+="<param><value><struct>"; 

s+="<member><name>title</name>" + 
"<value><string>"+title+"</string></value></member>"; 

s+="<member><name>description</name>" + 
"<value><string>"+content+"</string></value></member>"; 

s+="</struct></value></param>"; 

s+="<param><value><boolean>1</boolean></value></param>"; 

s+="</params>"; 

s+="</methodCall>"; 


return s; 


/* Bt Dialog ff} method */ 
private void showDialog(String mess) 


{ 
new AlertDialog.Builder (weib.this) .setTitle ("Message") 


-SetMessage (mess) 
.setNegativeButton (" 确 定 "，new DialogInterface.OnClickListener () 


t 
public void onClick(DialogInterface dialog, int which) 
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执行 后 的 效果 如 图 12-1 所 示 ， 只 要 拥有 乐 多 的 账号 ， 就 可 以 在 手机 上 发 送 移动 博客 。 


发 布 文章 


图 12-1 执行 效果 


12.4 详解 腾讯 Android 版 微 博 API 


作为 一 名 Android 学 习 者 来 说 ， 个 人 独立 开发 微 博 系统 的 难度 比较 大 。 在 目前 市 面 中 
有 很 多 著名 微 博 系统 的 开源 代码 ， 开 发 人 员 只 需 利用 它们 提供 的 APT 接口 即 可 方便 地 开发 
出 Android 版 的 移动 微 博 系统 。 当 今 市 面 中 著名 的 Android 版 的 移动 微 博 系统 有 新 浪 微 博 
和 腾讯 微 博 。 本 节 将 讲解 腾讯 微 博 系统 的 API 接口 。 


124.1 源码 和 jar 包 下 载 


因为 当前 腾讯 微 博 提 供 的 Java(Android) SDK 功能 过 弱 ， 所 以 特意 集成 了 一 个 Java 
SDK 包 ， 此 包 适 用 于 Android. Java SDK 包含 了 腾讯 微 博 目前 提供 的 95% 的 API， 用 法 简 
单 ( 微 博 、 评 论 、 转 发 、 私 信 同 一 个 实体 类 )， 方 便 扩展 (可 以 根据 自己 的 需要 修改 源 代码 或 
是 继承 QqTSdkService 类 ， 当 然 为 了 后 续 依 然 能 升级 版 本 ， 建 议 采 用 继承 的 方式 )。 

在 压缩 包 中 ，QqTAndroidSdk-1.0.0jar 是 SDK 的 主 代码 ， 其 中 QqTSdkServiceImpl 包 
含 了 所 有 接口 的 实现 ， 具 体 说 明 如 下 。 

OQ jar 包 地 址 : QqTAndroidSdk-1.0.0.jar。 

口 ”google code 源码 地 址 : http://code.google.com/p/qq-t-java-sdk/source/browse/。 

口 ”github 源码 地 址 : https://github.com/Trinea/qq-t-java-sdk。 


在 具体 使 用 之 前 ， 
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而 压缩 包 JavaCommon-1.0.0jar 是 QqTAndroidSdk 依赖 的 公用 处 理 包 ， 包 含 了 字符 
Hy list. BH. map, json 工具 类 等 ， 具 体 说 明 如 下 。 
口 jar 包 地 址 : 已 经 包含 在 QqTAndroidSdk-1.0.0 jar P o 
QU google code 源码 地 址 : http://code.google.com/p/trinea-java-common/source/browse/ « 
口 github 源码 地 址 : https://github.com/Trinea/JavaCommon。 


12.4.2 具体 使 用 


读者 请 先 参 考 腾 讯 微 博 的 API 文档 说 明 ， 地 址 是 : 


http://wiki.open.t.qq.com/index.php/API%E6%96%87%E6%A1%A3, WB 12-2 所 示 。 


Do 腾讯 微 博 开 放 平台 


开放 平台 

平台 介绍 
组 件 使 用 指引 
应 用 接 入 指引 
ERSTE SI 
移动 应 用 注入 
开发 者 协议 
KARERE 
平台 动态 

授权 
OAuthl.0a 监 权 
OAUth2 o 
Openid&openkey 监 权 
APLC 
Apis 
asma E] 
APRA 
APHBRIR 
OpemjJSUS 接 口 ) 


下 面 的 初始 化 代码 : 


/[** 


API 文 档 


返回 


注意 : 以 下 接口 使 用 说 明文 档 均 是 以 oauth1.0 鉴 权 为 例 进行 说 明 的 ， 因 此 洞 用 接口 时 使 用 的 是 http 方 式 ,而 
如 果 您 选择 使 用 oauth2.3 鉴 权 ， 那 么 凋 用 接口 时 请 换 成 https 请 求 方式 。 


OAuth ee Li mets 帐户 相关 FREE 
FAB amex mg as DEFES prred 
apax sex ze ames laste 
其 他 文人 更新 历史 APIIBIEQA d RETE 
OAuth 

request token Brequesttoken 

authorize 用 户 授权 request token 

access token StiBaccess token 

点 二 查看 示例 APERTO 

sas 

statuses/home timeline i0 

statuses/public timeline. TURAE 

statuses/user timeline. —€— 

statuses/mentions timeline APRA 


图 12-2 腾讯 微 博 的 API 文 档 页 面 
在 编码 使 用 API 接口 时 ， 需 要 先 新 建 QqTSdkService 类 对 象 并 进行 初始 化 工作 。 例 如 


* 分 别 设置 应 用 的 key. secret (腾讯 提供 ) 。 用 户 的 accesstoken 和 tokenSecret (OAuth 获取 ) 
* 请 用 自己 的 相应 字符 串 替换 ， 否 则 无 法 成 功 发 送 和 获取 数据 


**/ 


QqTAppAndToken 


qqTAppAndToken. 
qqTAppAndToken. 
qqTAppAndToken. 
qqTAppAndToken. 


/** Pi oqTSdkService 对 象 ， 并 设置 应 用 信息 和 用 户 访问 信息 **/ 
QqTSdkService qqTSdkService = 


qqTAppAndToken = 
setAppKey ("***") ; 


setAppSecret ("***") ; 
setAccessToken ("***") ; 
setTokenSecret ("***") ; 


new QqTAppAndToken () ; 


// *** 用 应 用 key 替换 
// *** 用 应 用 secret 替换 


new QqTSdkServiceImpl (); 


qqTSdkService.setQqTAppAndToken (qqTAppAndToken); 


// *** 用 用 户 accesstoken 蔡 换 
// *** 用 用 户 tokenSecret 4% 
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接 下 来 开始 对 接口 进行 详细 介绍 ， 并 举例 如 何 使 用 QqTAndroidSdk-1.0.0ar. 中 的 
API。 腾 讯 微 博 中 的 接口 主要 分 成 下 面 的 几 大 类 。 


1. 时 间 线 ( 微 博 列表 ) 


这 里 的 20 个 接口 包含 了 腾讯 微 博 四 部 分 API 
(1) 时 间 线 中 的 除 statuses/ht_timeline_ext( 话 题 时 间 线 ) 以 外 的 15 个 API. 

(2) 私信 相关 中 的 收 件 箱 、 发 件 箱 两 个 API。 

G) 数据 收藏 中 的 收藏 的 微 博 列 表 和 获取 已 订阅 话题 列表 两 个 APT 

(4) 微 博 相关 中 的 获取 单条 微 博 的 转发 或 点 评 列表 API。 

以 获取 首页 信息 为 例 ， 示 例 代码 如 下 : 

QqTTimelinePara qqTTimelinePara = new QqTTimelinePara(); 

/xx 设置 分 页 标识 **/ 

qqTTimelinePara.setPageFlag (0); 

/xx 设置 起 始 时 间 **/ 

qqTTimelinePara.setPageTime (0); 

/x+ 每 次 请 求 记录 的 条 数 **/ 

qqTTimelinePara.setPageReqNum(QqTConstant.VALUE PAGE REQ NUM); 

/** 可 以 设置 拉 取 类 型 ， 可 取 值 QqTConstant à VALUE STATUS TYPE TL + **/ 
qqTTimelinePara.setStatusType(QqTConstant.VALUE STATUS TYPE TL ALL); 

/xx 可 以 设置 微 博 内 容 类 型 ， 可 取 值 ogTConstant 中 VALUE CONTENT TYPE TL: **/ 
qqTTimelinePara.setContentType (QqTConstant.VALUE CONTENT TYPE TL ALL); 
List«QqTStatus» qqTStatusList - qqTSdkService.getHomeTL (qqTTimelinePara); 
assertTrue(qqTStatusList !- null); 


这 样 qqTStatusList 就 保存 了 首页 的 20 条 数据 ， 可 以 自行 设置 不 同 的 类 型 参数 。 如 果 
想 获取 更 多 的 时 间 线 数据 ， 请 读者 参考 腾讯 微 博 Java(Android) SDK 时 间 线 API 的 详细 
介绍 。 

2. 新 增 微 博 API 


在 本 书 成 稿 时 ， 腾 讯 微 博 新 增加 了 8 个 API. 

(1) 微 博 相 关中 的 发 表 一 条 微 博 、 转 播 一 条 微 博 、 回 复 一 条 微 博 、 发 表 一 条 带 图 片 微 
博 、 点 评 一 条 微 博 、 发 表 音 乐 微 博 、 发 表 视 频 微 博 、 发 表 心情 帖子 。 在 API 中 发 表 一 条 微 
博 和 发 表 一 条 带 图 片 微 博 合 二 为 一 。 

(2) 私信 相关 中 的 发 私信 操作 一 条 微 博 。 

以 新 增 一 条 微 博 为 例 ， 示 例 代码 如 下 : 

qqTSdkService.addStatus ("第 一 条 状态 哦 "，nul1); 


其 中 第 一 个 参数 为 状态 内 容 ， 第 二 个 参数 为 图 片 地址 ， 不 传 图 片 为 空 即 可 。 或 者 在 如 
下 复杂 代码 中 ，status 可 以 设置 其 他 地 理 位 置信 息 。 

QqTStatusInfoPara status = new QqTStatusInfoPara(); 

status.setStatusContent (" 发 表 一 条 带 图 片 微 博 啦 ") ; 

/** 发 表 带 图 微 博 ， 设 置 图 片 路 径 **/ 

status.setImageFilePath("/mnt/sdcard/DCIM/Camera/IMAG2150.jpg"); 

assertTrue (qqTSdkService.addstatus (status, qqTAppAndToken)); 
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这 8 个 接口 包含 了 腾讯 微 博 两 部 分 API。 

3. 操作 一 条 微 博 

(1) 微 博 相关 中 的 删除 一 条 微 博 API。 

(2) 私信 相关 中 的 删除 私信 API。 

G) 数据 收藏 中 的 收藏 微 博 、 取 消 收 藏 微 博 、 订 阅 话题 、 取 消 订阅 话题 4 个 APT. 

以 收藏 一 条 微 博 为 例 ， 示 例 代码 如 下 : 

qqTSdkService.collect (12121); 

其 中 参数 为 微 博 ID. 

4. 关系 链 列表 (用 户 列表 ) 

这 10 个 接口 包含 了 腾讯 微 博 关系 链 相关 中 的 互 听 关 系 链 列表 (对 某 个 用 户 而 言 ， 既 是 
他 的 听众 又 被 他 收听 )、 其 他 账号 听众 列表 、 其 他 账号 收听 的 人 列表 、 其 他 账户 特别 收听 的 
人 列表 、 黑 名 单列 表 、 我 的 听众 列表 、 我 的 听众 列表 (只 包含 名 字 )、 我 收听 的 人 列表 、 我 
收听 的 人 列表 (只 包含 名 字 )、 我 的 特别 收听 列表 10 个 API。 

以 获取 自己 的 收听 用 户 为 例 ， 示 例 代码 如 下 所 示 

QqTUserRelationPara qqTUserRelationPara = new QqTUserRelationPara(); 

qqTUserRelationPara.setReqNumber (QqTConstant.VALUE PAGE REQ NUM); 

qqTUserRelationPara.setStartIndex (0) ; 


List<QqTUser> qqTUserList = 
qqTSdkService.getSelfInterested (qqTUserRelationPara); 


5. 用 户 建立 关系 

这 6 个 接口 包含 了 腾讯 微 博 关系 链 相关 中 的 收听 某 个 用 户 、 取 消 收 听 某 个 用 户 、 特 别 
收听 某 个 用 户 、 取 消 特别 收 听 某 个 用 户 、 添 加 某 个 用 户 到 黑 名 单 、 从 黑 名 单 中 删除 某 个 用 
户 共 6 个 API。 

以 关注 某 些 用 户 为 例 ， 示 例 代 码 如 下 


qqTSdkService.interestedInOther("wenzhang,li nian,mayili007", null) 


6. 账户 相关 


这 7 个 接口 包含 了 腾讯 微 博 账户 相关 中 的 获取 自己 的 详细 资料 、 更 新 用 户 信息 、 更 新 
用 户头 像 信息 、 更 新 用 户 教 育 信息 、 获 取 其 他 人 资料 、 获 取 一 批 人 的 简单 资料 、 验 证 账户 
是 否 合法 (是 否 注册 微 博 ) 共 7 个 API。 除 获取 心情 微 博 API 外 。 

以 获取 自己 的 资料 为 例 ， 示 例 代码 如 下 : 

QqTUser qqTUser = qqTSdkService.getSelfInfo(); 

7. 搜索 相关 


这 3 个 接口 包含 了 腾讯 微 博 搜索 相关 中 的 搜索 用 户 、 搜 索 微 博 、 通 过 标签 搜索 用 户 共 
3 个 API。 以 搜索 微 博 为 例 ， 示 例 代码 如 下 : 
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public void testSearchStatus() { 
QqTSearchPara qqTSearchPara = new QqTSearchPara(); 
qqTSearchPara.setKeyword ("iphone"); 
qqTSearchPara.setPage (1); 
qqTSearchPara.setPageSize(QqTConstant.VALUE PAGE REQ NUM); 
List«QqTStatus» qqTStatusList = 

qqTSdkService.searchStatus (qqTSearchPara); 
assertTrue(qqTStatusList !- null); 

} 


8. 热度 趋势 相关 


这 两 个 接口 包含 了 腾讯 微 博 热 度 趋势 中 的 话题 热 榜 、 转 播 热 榜 用 户 共 两 个 API。 以 话 
题 热 榜 为 例 ， 示 例 代码 如 下 : 


public void testGetHotTopics() { 
QqTHotStatusPara qqTHotStatusPara = new QqTHotStatusPara(); 
qqTHotStatusPara.setReqNum(QqTConstant.VALUE PAGE REQ NUM); 
qqTHotStatusPara.setLastPosition (0); 
/** 
* 1: 话题 名 ，2: 搜索 关键 字 ，3: 两 种 类 型 都 有 
**/ 
qqTHotStatusPara.setType (Integer.toString(1)); 
List<QqTTopicSimple> hotTopicsList = 
qqTSdkService.getHotTopics (qqTHotStatusPara) ; 
assertTrue(hotTopicsList != null); 


) 


9. 数据 更 新 
这 一 个 接口 为 腾讯 微 博 数据 更 新 相关 中 的 查看 数据 更 新 条 数 API， 示 例 代码 如 下 : 
public void testGetUpdateInfoNum() ( 
/** 设置 clearType， 对 应 QqTConstant.VALUE CLEAR TYPE … **/ 
QqTUpdateNumInfo qqTUpdateNumInfo = 
qqTSdkService.getUpdateInfoNum (true, 
QqTConstant.VALUE CLEAR TYPE HOME PAGE); 


assertTrue (qqTUpdateNumInfo != null); 
} 


10. 发 起 话题 
这 两 个 接口 是 为 腾讯 微 博 中 的 话题 应 用 服务 的 ， 可 以 根据 话题 名 称 查询 话题 ID 和 根 
据 话 题 ID 获取 话题 相关 信息 API。 示 例 代码 如 下 : 
public void testGetTopicInfoByIds() { 
/** 先 得 到 话题 ID **/ 
Map<String, String> topicIdAndName = 


qqTSdkService.getTopicIdByNames ("Fi IN M$, 美 汁 源 下 架 , iphone"); 
if (topicIdAndName != null) { 
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/** 话题 ID 列表 ， 以 逗号 分 隔 **/ 
List«QqTStatus» qqtStatusList = qqTSdkService.getTopicInfoByIds 
(ListUtils.join(new ArrayList«String» (topicIdAndName.keySet ()))); 

assertTrue(qqtStatusList != null); 

} else ( 
assertTrue (false) ; 

Ü 

} 


11. 标签 相关 
这 两 个 接口 为 腾讯 微 博 标 签 相关 中 的 添加 标签 和 删除 标签 API， 示 例 代码 如 下 : 


public void testDeleteTag() ( 
/** 删除 自己 的 tag， 先 获取 自己 的 资料 ， 从 中 取 中 tag ia **/ 
QqTUser qqTUser = qqTSdkService.getSelfInfo(); 
if (qqTUser !- null && qqTUser.getTagMap() !- null && 
qqTUser.getTagMap().size() » 0) ( 
/** HBR tag **/ 
for (Map.Entry<String, String> tag : 
qqTUser.getTagMap().entrySet()) ( 
qqTSdkService.deleteTag (tag.getKey()); 
} 
} else { 
assertTrue (false); 
} 


12.5 详解 新 廊 Android 版 微 博 API 


新 浪 微 博 是 国内 最 早 推出 微 博 应 用 的 行业 站 点 ， 为 了 帮助 Android 程序 员 开发 可 以 使 
用 新 浪 微 博 的 应 用 ， 特 意 提供 了 开源 API 供 大 家 参考 。 读 者 要 想 了 解 在 Android 平台 使 用 
新 浪 微 博 的 知识 ， 可 以 登录 http://open.weibo.com/wiki/%E9%A6%96%E9%A1%B5 获取 详 
细 资 料 ， 并 且 在 网 页 中 可 以 获取 开源 代码 。 

在 Android 中 使 用 新 浪 微 博 的 开发 平台 API 的 基本 步骤 如 下 。 

1. 通过 官方 网 址 下 载 SDK 

当前 的 最 新 版 本 是 Weibo4Android， 下 载 地 址 是 : 

http://code.google.com/p/weibo4j/downloads/detail?name=weibo4android-1.2.1.zip 

此 页 面 的 界面 效果 如 图 12-3 所 示 。 


> Andid sssanAnsma 
weibo4j 


Sina Mblog openAPI javaSDK 


Project Home | Downloads | Wiki Issues Source 


Search [ Current downloads =] for | Search 


Download: Weibo4Android 1.2.1 full source&examples 


Uploaded by: haidona_.@amail.com 


Released: 2011 ile: " " 1 
File: A 

.2.1.zip 
i SDAA (=) weibo4android-1.2.1.zip 596 KB 
Downloads: 10393 Description: 1 bald ett a 

2、 增 加 user: city. provice 
bo4: id = 34 3j 

bios 3、 修 改 加 关注 方法 为 post 
weibo 4、 支 持 comment 返 回 status，replycomment 字 段 
sina 5、 处 理 上 一 版 本 翻 页 采用 cursor 参 数 bug 
3 SHA1 Checksum: 6f2ec90b037b2055e2c69dceed023d706f339ec0 What's this? 


api 
sdk 


图 12-3 ”下载 SDK 页 面 

2. 认证 

TE SDK 中 有 完整 的 如 何 通过 OAuth 认证 的 演示 实例 。 认 证 和 使 用 流程 如 下 。 

(1) fE/weibo4android/src/weibo4android/Weibo.java 设置 App Key 和 App Secret( 在 官 
方 网 站 新 建 应 用 可 获得 )， 如 下 所 示 : 

public static String CONSUMER KEY = "2664209963"; 

public static String CONSUMER SECRET = 

"p428615797a54d676d428cd146c040399"; 

(2) fE/weibo4android/examples/weibo4android/androidexamples/AndroidExample.java 中 ， 
将 App Key 和 App Secret 设置 进 系统 类 中 : 

System. setProperty ("weibo4j.oauth.consumerKey", Weibo.CONSUMER KEY); 


System.setProperty ("weibo4j.oauth.consumerSecret", 
Weibo. CONSUMER SECRET); 


(3) 通过 HTTP Post 方式 向 服务 提供 方 请 求 获得 RequestToken. 


RequestToken requestToken 
=weibo.getOAuthRequestToken ("weibo4android://OAuthActivity"); 


(4) 将 用 户 引导 至 授权 页 面 。 


Uri uri = Uri.parse (requestToken.getAuthenticationURL ()+ 
"&display-mobile"); 
startActivity (new Intent(Intent.ACTION VIEW, uri)); 


(5) 授权 页 面 要 求 用 户 输入 用 户 名 和 密码 ， 授 权 完 成 后 ， 服 务 提供 方 会 通过 回调 URL 
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将 用 户 引导 回 客户 端 页 面 OAuthActivity 页 面 。 


«activity android:name=".OAuthActivity"> 

<intent-filter> 
«action android:name-"android.intent.action.VIEW" /> 
«category android:name-"android.intent.category.DEFAULT" /> 
«category android:name-"android.intent.category.BROWSABLE" /> 
«data android:scheme="weibo4android" android:host-"OAuthActivity" /> 

«/intent-filter» 
«/activity» 


(6) 客户 端 根据 临时 令 牌 和 用 户 授权 码 从 服务 提供 方 那里 获取 访问 令 牌 (Access 
Token). 


Uri uri-this.getIntent ().getData(); 

RequestToken requestToken- OAuthConstant.getInstance().getRequestToken(); 
AccessToken 

accessToken=requestToken.getAccessToken (uri.getQueryParameter("oauth ver 
ifier")); 


(7) 获得 访问 令 牌 后 便 可 使 用 API 接口 获得 和 操作 用 户 数据 。 


Weibo weibo-OAuthConstant.getInstance().getWeibo(); 
weibo.setToken (OAuthConstant.getInstance() .getToken(), 
OAuthConstant.getInstance().getTokenSecret ()); 
String[] args = new String[2]; 
args [0]=OAuthConstant.getInstance() .getToken () ; 
args [1]=OAuthConstant.getInstance() .getTokenSecret () ; 
try { 

GetFollowers.main (args) ;// 返 回 用 户 关注 对 象 列 表 ， 并 返回 最 新 微 博文 章 
) catch (Exception e) ( 

e.printStackTrace(); 


} 

在 上 述 步骤 中 ，weibo4android 是 XML 文件 中 定义 的 索引 名 ， 在 步骤 (53) 的 XML 代码 
中 ，<data android:scheme="weibo4android" android:host="OAuthActivity" /> 部 分 的 索引 名 是 
自 定义 的 ， 只 要 与 Java 代码 中 的 URL 匹配 即 可 。 

在 下 面 的 内 容 中 ， 将 不 再 剖析 Android 版 新 浪 微 博 的 实现 源码 ， 而 是 以 此 为 基础 ， 讲 
解 二 次 扩展 开发 的 基本 知识 。 


12.5.4. ”新浪 微 博 图 片 缩放 的 开发 实例 


在 Android 开发 过 程 中 ， 有 时 会 用 到 图 片 缩放 效果 ， 即 点 击 图 片 时 显示 缩放 按钮 ， 过 
一 会 消失 。 下 面 将 根据 新 浪 微 博 的 图 片 缩放 原理 编写 演示 代码 以 供 参 考 。 
(1) UL 布局 文件 的 演示 代码 如 下 : 
<?xml version-"1.0" encoding-"utf-8"?» 
<FrameLayout xmlns:android-"http://schemas.android.com/apk/res/android" 


android: orientation-"vertical" 
android:layout width-"fill parent" 
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android:layout height-"fill parent" 
android: id="@+id/layout1" 
> 


<RelativeLayout xmlns:android="http: //schemas .android.com/apk/res/android" 
android:layout width="fill parent" 
android:layout height-"fill parent" 
android:id="@+id/rl" 
> 


<ScrollView xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width="fill parent" 
android:layout height="fill parent" 
android:layout weight="19" 
android: scrollbars="none" 
fadingEdge-"vertical" 
layout gravity-"center" 
android:gravity-"center" 
> 


<HorizontalScrollview 
android:layout height="fill parent" 
android:layout width-"fill parent" 
android:scrollbars-"none" 
android:layout gravity-"center" 
android:gravity-"center" 
android: id="@+id/hs" 


> 
<LinearLayout 
android: orientation-"horizontal" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android: id="@+id/layoutImage" 
android:layout gravity="center" 
android: gravity="center" 
> 
<ImageView 
android:layout gravity="center" 
android:gravity="center" 
android: id="@+id/myImageView" 
android:layout width="fill parent" 
android:layout height="fill parent" 
android:layout weight="19" 
android:paddingTop="5dip" 
android:paddingBottom="5dip" 


le, 
</LinearLayout> 
</HorizontalScrollView > 
</ScrollView> 
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<ZoomControls android:id="@+id/zoomcontrol" 
android:layout width-"wrap content" android:layout height- 
"wrap content" android:layout centerHorizontal-"true" 
android:layout alignParentBottom-"true" 
> 
</ZoomControls> 
</RelativeLayout> 


</FrameLayout> 


(2) 用 Java 编写 主 程序 代码 ， 代 码 如 下 : 


package com.Johnson.image.zoom; 
import android.app.Activity; 
import android.app.Dialog; 
import android.app.ProgressDialog; 
import android.content.DialogInterface; 
import android.content.DialogInterface.OnKeyListener; 
import android.graphics.Bitmap; 
import android.graphics.BitmapFactory; 
import android.graphics.Matrix; 
import android.os.Bundle; 
import android.os.Handler; 
import android.util.DisplayMetrics; 
import android.util.Log; 
import android.view.KeyEvent; 
import android.view.MotionEvent; 
import android.view.View; 
import android.view.View.OnClickListener; 
import android.widget.ImageView; 
import android.widget.LinearLayout; 
import android.widget.RelativeLayout; 
import android.widget.ZoomControls; 
public class MainActivity extends Activity ( 
/** Called when the activity is first created. */ 
private final int LOADING IMAGE - 1; 
public static String KEY IMAGEURI - "ImageUri"; 
private ZoomControls zoom; 
private ImageView mImageView; 
private LinearLayout layoutImage; 
private int displayWidth; 
private int displayHeight; 
/** 图 片 资 源 */ 
private Bitmap bmp; 
/** 宽 的 缩放 比例 */ 
private float scaleWidth = 1; 
/** 高 的 缩放 比例 */ 
private float scaleHeight = 1; 
/** 用 来 计数 放大 +1; 缩小 -1*/ 


private int zoomNumber=0; 


B Android sz nsma 


/*#* 点 击 屏幕 显示 缩放 按钮 ，3 秒 消失 */ 
private int showTime=3000; 
RelativeLayout rl; 
Handler mHandler - new Handler(); 
private Runnable task - new Runnable() ( 

public void run() ( 

zoom.setVisibility (View.INVISIBLE); 

H 

He 


@override 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView (R. layout .main) ; 
//showDialog (LOADING IMAGE) ; 
// 图 片 是 从 网 络 上 获取 的 话 ， 需 要 加 入 滚动 条 
bmp=BitmapFactory.decodeResource (getResources(), R.drawable.image); 
//removeDialog (LOADING IMAGE); 
initZoom(); 
) 
@override 
protected Dialog onCreateDialog(int id) { 
switch (id) { 
case LOADING IMAGE: { 
final ProgressDialog dialog = new ProgressDialog (this); 
dialog.setOnKeyListener (new OnKeyListener() { 
@override 
public boolean onKey(DialogInterface dialog, int keyCode, 
KeyEvent event) { 
if (keyCode == KeyEvent.KEYCODE BACK) { 
finish(); 
} 
return false; 
H 
); 
dialog.setMessage (" 正 在 加 载 图 片 请 稍 后 . . .") 
dialog.setIndeterminate (true); 
dialog.setCancelable (true); 
return dialog; 
5 
H 
return null; 


) 
public void initZoom() ( 


/* 取得 屏幕 分 辩 率 大 小 */ 

DisplayMetrics dm = new DisplayMetrics(); 
getWindowManager().getDefaultDisplay().getMetrics (dm); 
displayWidth = dm.widthPixels; 

displayHeight = dm.heightPixels; 

mlImageView = (ImageView) findViewById(R.id.myImageView); 
mImageView.setImageBitmap (bmp); 
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layoutImage = (LinearLayout) findViewById(R.id.layoutImage) ; 
mImageView.setOnClickListener (new OnClickListener() { 


@override 
public void onClick(View v) { 
// TODO Auto-generated method stub 
[** 
* 在 图 片上 和 整个 View 上 同时 添加 点 击 监听 和 捕捉 屏幕 
* 点 击 事件 ， 来 显示 放大 或 缩小 按钮 
* */ 
zoom.setVisibility (View.VISIBLE) ; 
mHandler.removeCallbacks (task); 
mHandler.postDelayed(task, showTime); 
} 
he 
layoutImage.setOnClickListener(new OnClickListener() { 


@Override 
public void onClick(View v) { 
// TODO Auto-generated method stub 


zoom. setVisibility (View.VISIBLE) ; 
mHandler.removeCallbacks (task); 
mHandler.postDelayed(task, showTime); 
} 
}); 


zoom = (ZoomControls) findViewById(R.id.zoomcontrol) ; 
zoom.setIsZoomInEnabled (true); 
zoom.setIsZoomOutEnabled (true); 
// 图 片 放 大 
zoom.setOnZoomInClickListener (new OnClickListener() ( 
public void onClick(View v) ( 
big; 
} 
p; 
// 图 片 缩小 


zoom.setOnZoomOutClickListener (new OnClickListener() ( 


public void onClick(View v) ( 
small(); 


n; 
zoom.setVisibility (View.VISIBLE) ; 
mHandler.postDelayed(task, showTime) ; 


@override 
public boolean onTouchEvent (MotionEvent event) { 
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// TODO Auto-generated method stub 
/[** 
* 在 图 片上 和 整个 View 上 同时 添加 点 击 监听 和 捕捉 屏幕 
* 点 击 事件 ， 来 显示 放大 或 缩小 按钮 
*/ 
zoom.setVisibility (View.VISIBLE) ; 
mHandler.removeCallbacks (task); 
mHandler.postDelayed(task, showTime); 
return false; 


GOverride 

public boolean onKeyDown(int keyCode, KeyEvent event) ( 
// TODO Auto-generated method stub 
super.onKeyDown (keyCode, event); 


return true; 
} 


/* 图 片 缩小 的 method */ 

private void small() ( 
-—-zoomNumber; 
int bmpWidth = bmp.getWidth(); 
int bmpHeight = bmp.getHeight (); 


Log.i("","bmpWidth = " + bmpWidth + ", bmpHeight = " + bmpHeight); 


/* 设置 图 片 缩小 的 比例 */ 

double scale = 0.8; 

/* 计算 出 这 次 要 缩小 的 比例 */ 

ScaleWidth = (float) (scaleWidth * scale); 

scaleHeight = (float) (scaleHeight * scale); 

/* 产生 resize Jill) Bitmap 对 象 */ 

Matrix matrix = new Matrix(); 

matrix.postScale(scaleWidth, scaleHeight); 

Bitmap resizeBmp = Bitmap.createBitmap (bmp, 0, 0, bmpWidth, bmpHeight, 
matrix, true); 

mImageView. set ImageBitmap (resizeBmp) ; 


/* 限制 缩小 尺寸 */ 
if ((scaleWidth * scale * bmpWidth < bmpWidth / 4 
|| scaleHeight * scale * bmpHeight > bmpWidth /4 
|| scaleWidth * scale * bmpWidth > displayWidth / 5 
|| scaleHeight * scale * bmpHeight > displayHeight / 
5)&&(zoomNumber---1) )( 


zoom. setIsZoomOutEnabled (false); 
} else { 


zoom. setIsZoomOutEnabled (true); 
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zoom.setIsZoomInEnabled (true); 
System.gc(); 
} 


/* 图 片 放大 的 method */ 

private void big() { 
++zoomNumber; 
int bmpWidth = bmp.getWidth(); 
int bmpHeight = bmp.getHeight (); 


/* 设置 图 片 放大 的 比例 */ 
double scale = 1.25; 
/* 计算 这 次 要 放大 的 比例 */ 
ScaleWidth = (float) (scaleWidth * scale); 
scaleHeight = (float) (scaleHeight * scale); 
/* 产生 resize Jill) Bitmap 对 象 */ 
Matrix matrix = new Matrix(); 
matrix.postScale(scaleWidth, scaleHeight); 
Bitmap resizeBmp = Bitmap.createBitmap (bmp, 0, 0, bmpWidth, bmpHeight, 
matrix, true); 
mImageView.setImageBitmap (resizeBmp) ; 
/* 限制 放大 尺寸 */ 
if (scaleWidth * scale * bmpWidth > bmpWidth * 4 
|| scaleHeight * scale * bmpHeight > bmpWidth * 4 
|| scaleWidth * scale * bmpWidth > displayWidth * 5 
|| scaleHeight * scale * bmpHeight > displayHeight * 5) { 


zoom. setIsZoomInEnabled (false); 
} else { 


zoom. setIsZoomInEnabled (true); 


zoom. setIsZoomOutEnabled (true); 


System.gc(); 
) 


125.2 ”添加 分 享 到 新 浪 微 博 


现在 很 多 平台 都 开放 了 ， 并 且 提 供 了 相应 的 接口 。 在 过 去 你 浏览 论坛 或 者 博客 的 时 
候 ， 论 坛 或 博客 都 需要 自己 的 账号 ， 但 是 现在 你 会 发 现 都 有 一 个 “用 新 浪 微 博 登录 ”、 


e 


论坛 或 者 博客 了 ， 这 确实 是 挺 方便 的 


WA 
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“用 QQ 账号 登录 ”等 的 字样 。 这 样 经 过 授权 以 后 你 就 可 以 用 新 浪 或 者 腾讯 的 账号 登录 到 


情 ， 可 以 直接 为 你 的 社区 带 来 上 


户 流 


最 近 开 发 的 应 用 都 涉及 分 享 的 功能 ，Android 系统 有 内 置 的 分 享 功能 ， 


图 12-4 所 示 。 


授权 云 脉 CC 访问 你 的 微 博 帐号 


图 12-4 Android 系 统 内置 的 分 享 


m- 
里 。 


但 是 内 置 的 分 


有 在 你 安装 该 应 用 的 时 候 才 会 被 显示 在 列表 中 ， 下 面 是 Android 系统 内 置 的 分 享 ， 如 


选择 图 12-4 中 的 “分 享 ” 选 项 后 即 可 看 到 “新 浪 微 博 ”， 这 个 是 笔者 自己 添加 的 。 意 
思 就 是 说 : 如 果 安 装 了 “新 浪 微 博 ” 移 动 端 ， 就 用 系统 自己 的 分 享 。 如 果 没 有 安装 该 应 


用， 则 需 自行 添加 分 享 到 “新 浪 微 博 ” 的 功能 。 下 面 我 们 看 看 这 个 列表 


Intent intent = new Intent(Intent.ACTION SEND); 
intent.setType ("text/plain"); 


ShareAdapter mAdapter = new ShareAdapter (mContext, intent); 


// 对 话 框 的 适配器 
public class ShareAdapter extends BaseAdapter { 


么 加 载 的 : 


private final static String PACKAGENAME = "com.sina.weibo"; 


private Context mContext; 

private PackageManager mPackageManager; 
private Intent mIntent; 

private LayoutInflater mInflater; 
private List«ResolveInfo» mList; 


private List«DisplayResolveInfo» mDisplayResolveInfoList; 


public ShareAdapter(Context context, Intent intent) ( 
mContext = context; 
mPackageManager = mContext.getPackageManager () ; 
mIntent = new Intent (intent); 


mInflater = (LayoutInflater)mContext.getSystemService 


(Context.LAYOUT INFLATER SERVICE); 


mList = mContext.getPackageManager ().queryIntentActivities 


(intent, PackageManager.MATCH DEFAULT ONL 
// 排序 


ResolveInfo.DisplayNameComparator comparator = ne 


Y); 


W 


ResolveInfo.DisplayNameComparator (mPackageManager) ; 


Collections.sort (mList, comparator); 
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mDisplayResolveInfoList = new ArrayList«DisplayResolveInfo»(); 
if (mList == null || mList.isEmpty()) { 
mList = new ArrayList«ResolveInfo»(); 
) 
final int N = mList.size(); 
for (int i = 07 3 < Nz itt) { 
ResolveInfo ri = mList.get (i); 
CharSequence label = ri.loadLabel (mPackageManager) ; 
DisplayResolveInfo d = new DisplayResolveInfo(ri, null, null, 
label, null); 
mDisplayResolveInfoList.add (d); 


} 

// 考 虑 是 否 已 安装 新 浪 微 博 ， 如 果 没 有 ， 则 自行 添加 

if(!isInstallApplication (mContext, PACKAGENAME) ) { 
Intent i = new Intent (mContext, ShareActivity.class); 
Drawable d = mContext.getResources ().getDrawable (R.drawable.sina) ; 
CharSequence label = mContext.getString(R.string.about sina weibo); 
DisplayResolveInfo dr = new DisplayResolveInfo(null, i, null, 

label, d); 

mDisplayResolveInfoList.add(0, dr); 


} 
GOverride 
public int getCount() ( 
return mDisplayResolveInfoList.size(); 


GOverride 
public Object getItem(int position) ( 
return mDisplayResolveInfoList.get (position); 


GOverride 
public long getItemId(int position) ( 
return position; 
) 
GOverride 
public View getView(int position, View convertView, ViewGroup parent) 


View item; 


if (convertView == null) { 
item = mInflater.inflate(R.layout.share item, null); 
} else { 


item = convertView; 


) 
DisplayResolveInfo info = mDisplayResolveInfoList.get (position); 


ImageView i = (ImageView) item.findViewById(R.id.share item icon); 
if(info.mDrawable == null)( 

i.setImageDrawable (info.mResoleInfo.loadIcon (mPackageManager)); 
}else{ 
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i.setImageDrawable (info.mDrawable); 


TextView t = (TextView) item.findViewById(R.id.share item text); 
t.setText (info.mLabel); 
return item; 


public ResolveInfo getResolveInfo(int index)( 
if(mDisplayResolveInfoList == null)( 
return null; 
} 
DisplayResolveInfo d = mDisplayResolveInfoList.get (index); 
if(d.mResoleInfo == null)( 
return null; 


) 
return d.mResoleInfo; 


// 返 回 跳 转 intent 
public Intent getIntentForPosition(int index) ( 
if(mDisplayResolveInfoList == null)( 
return null; 
) 
DisplayResolveInfo d - mDisplayResolveInfoList.get (index); 
Intent i = new Intent(d.mIntent == null ? mIntent : d.mIntent); 
i.addFlags(Intent.FLAG ACTIVITY FORWARD RESULT | 
Intent.FLAG ACTIVITY PREVIOUS IS TOP); 
if(d.mResoleInfo !- null)( 
ActivityInfo a = d.mResoleInfo.activityInfo; 
i.setComponent (new ComponentName 
(a.applicationInfo.packageName, a.name)); 
) 
return i; 
) 


// 检 查 是 否 安装 该 RPP 
boolean isInstallApplication(Context context, String packageName) { 
try ( 
mPackageManager 
-getApplicationInfo (packageName, 
PackageManager.GET UNINSTALLED PACKAGES); 
return true; 
) catch (NameNotFoundException e) ( 
return false; 
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* @author Administrator 

ai 

class DisplayResolveInfo { 
private Intent mIntent; 
private ResolveInfo mResoleInfo; 
private CharSequence mLabel; 
private Drawable mDrawable; 
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DisplayResolveInfo (ResolveInfo resolveInfo, Intent intent, 
CharSequence info, CharSequence label, Drawable d) ( 


this.mIntent = intent; 
this.mResoleInfo = resolveInfo; 
this.mLabel = label; 
this.mDrawable - d; 


} 


以 上 是 加 载 弹 出 对 话 框 的 数据 适配器 ， 如 果 系 统 已 经 安装 了 ， 则 直接 读 取 系统 的 分 


享 ， 没 有 安装 ， 则 添加 。 当 你 点 击 分 享 微 博 的 时 候 ， 就 需要 一 系列 的 验 


证 和 授权 了 ， 这 边 


采用 的 机 制 是 先 获取 requestToken， 再 通过 requestToken 获取 AccessToken， 然 后 才 可 以 分 
享 微 博 。 开 始 的 时 候 笔者 也 是 从 新 浪 官方 的 现在 的 SDK 不 知道 是 1.0 还 是 2.0， 但 是 始终 
都 不 能 发 送 微 博 ， 诡 异 的 是 用 官方 的 SDK 可 以 认证 完成 ， 并 能 够 获取 微 博 内 容 ， 但 是 死 
活 发 不 了 微 博 ， 郁 问好 几 天 。 但 是 看 到 它 的 官方 论坛 里 面 有 那么 多 的 受害 者 ， 我 表示 沉 


默 ， 一 个 借 大 的 公司 提供 一 个 接口 居然 成 这 样 。 现 在 我 用 的 这 个 


SDK 版 本 里 面 的 


Weibo.java 有 很 多 其 他 的 方法 ， 如 获取 用 户 信息 、 收 藏 微 博 等 ， 大 家 可 以 自己 看 看 。 


接 下 来 是 在 你 点 击 “ 分 享 到 微 博 ”的 时 候 进 行 认证 用 户 。 首 先 说 明 
读 取 新 浪 提供 的 页 面 ， 显 示 的 界面 如 图 12-4 右 图 ， 下 面 是 部 分 代码 : 
Weibo weibo = new Weibo(); 


RequestToken requestToken = 
weibo.getOAuthRequestToken ("yunmai://ShareActivity") ; 


-下 这 里 的 认证 是 


«span style="color:#e53333;">// 与 配置 中 对 应 </span> Log.i(TAG, "token:" + 


requestToken.getToken() + ",tokenSecret:" + 

requestToken.getTokenSecret ()); 

OAuthConstant.getInstance().setRequestToken (requestToken) 

Uri uri = Uri.parse (requestToken.getAuthenticationURL() + 

"&display-mobile"); 

url = uri.toString(); 

上 面 的 地 址 URL 就 是 你 请 求 新 浪 提 供 的 登录 界面 的 地 址 ， 这 里 会 浊 
用 。 在 Android 中 Webview 其 实 就 是 一 个 小 型 浏览 器 ， 功 能 很 强大 ， 
本 。 有 了 地 址 可 以 通过 webview.loadurl(URL) 请 求 登录 界面 。 也 有 很 多 
计 一 个 登录 界面 ， 但 是 新 浪 官方 有 说 明 ， 通 过 getXauthAccessToken 方 
设计 登录 界面 的 ， 其 他 认证 方式 是 不 能 够 自行 设计 的 。 在 你 单 击 “ 授 权 
到 我 们 自己 的 Activity 这 里 的 配置 是 需要 在 androidmanifestxml 中 进行 
跳 转 的 是 shareactivity.java。 


; 


上 及 Webview 的 使 
强大 到 可 以 执行 脚 
网 友 可 能 想 自 己 设 
式 认 证 是 可 以 自行 
”按钮 时 需要 跳 转 
配置 ， 比 如 我 这 边 
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<activity 

android:name-"cn.yunmai.cclauncher.ShareActivity" 

android:screenOrientation-"portrait" > 

<intent-filter> 
«action android:name-"android.intent.action.VIEW" /> 
«category android:name-"android.intent.category.DEFAULT" /> 
«category android:name-"android.intent.category.BROWSABLE" /> 
«data android:host-"ShareActivity" android:scheme-"yunmai" /> 

«/intent-filter» 

</activity> 


需要 注意 的 是 ， 在 <data> 标 签 中 的 内 容 需 要 和 显示 授权 窗口 中 的 
weibo.getOAuthRequestToken("yunmai://ShareActivity") 相 对 应 。 在 授权 完成 之 后 就 会 跳 转 到 
自己 定义 的 Activity， 授 权 完 成 之 后 就 可 发 微 博 了 ， 跳 转 之 后 的 Activity 现在 就 比较 清楚 明 
白 了 ， 简 单 点 就 可 以 放 一 个 “发 送 ” 按 钮 ， 一 个 editText 就 可 以 了 。 在 你 单 击 “ 发 送 ” 按 
钮 的 时 候 ， 你 要 获取 刚才 授权 成 功 的 RequestToken， 然 后 再 获取 accessToken， 最 后 发 送 微 
博 。 需 要 注意 的 是 ，RequestToken 只 需 获 取 一 次 ， 然 后 保存 你 的 accessToekn， 这 个 是 你 每 
次 都 需要 使 用 的 口令 ， 这 里 就 可 以 优化 一 下 体验 了 。 单 击发 送 按钮 的 操作 是 : 

Uri uri = this.getIntent().getData(); 

RequestToken requestToken = 

OAuthConstant.getInstance() .getRequestToken () ; 

AccessToken accessToken = 

requestToken.getAccessToken (uri.getQueryParameter("oauth verifier") ); 

saveAccessToken (accessToken) ; //f f accessToken 

Log.i(TAG, "oauth verifier:" + uri.getQueryParameter("oauth verifier") + 

",Token" + accessToken.getToken() + ",TokenSecret:" + 
accessToken.getTokenSecret ()) ; 

OAuthConstant.getInstance() .setAccessToken (accessToken) ; 


这 里 所 执行 的 操作 是 获取 授权 之 后 的 accessToken， 然 后 发 送 微 博 : 


Weibo weibo = OAuthConstant.getInstance().getWeibo(); 
weibo.setToken (OAuthConstant.getInstance().getToken(), 
OAuthConstant.getInstance ().getTokenSecret ()) ; 

Status s = weibo.updateStatus (mEdit.getText ().toString()); 


status 返回 了 一 些 详细 的 信息 ， 有 发 送 时 间 和 用 户 ID 等 ， 这 就 样 就 完成 了 分 享 功能 。 
12.5.3 ”通过 Json 对 象 登录 新 浪 微 博 


我 们 可 以 引用 新 浪 开发 包 中 的 各 种 类 ， 在 Android 中 通过 ISON 对 象 的 方式 登录 新 浪 
微 博 。 在 下 面 的 代码 中 ，1 代表 登录 成 功 ，0 代表 登录 失败 ， 并 通过 方法 verifyCredentials() 
请 求 新 浪 微 博 服务 器 返回 Ison 对 象 。 


package com.sfc.ui; 


import java.util.ArrayList; 
import java.util.List; 
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import com.sfc.ui.adapter.LoginListAdapter; 


import weibo4j.User; // 这 是 新 浪 开 发 包 中 的 实体 类 
import weibo4j.Weibo; // 这 是 新 浪 开 发 包 中 的 类 
import weibo4j.WeiboException; // 这 是 新 浪 开 发 包 中 的 类 


import android.app.Activity; 
import android.app.AlertDialog; 
import android.app.ProgressDialog; 
import android.os.Bundle; 

import android.os.Handler; 

import android.os.Message; 

import android.util.Log; 

import android.view.View; 

import android.view.View.OnClickListener; 
import android.widget.Button; 
import android.widget.ListView; 
import android.widget.Toast; 


public class LoginActivity extends Activity implements Runnable ( 
private Button loginButton; 

private ListView listView; 

private ProgressDialog loginDialog; 

private Thread loginThread; 

private Handler handler; 

@override 

protected void onCreate (Bundle savedInstanceState) { 
super .onCreate (savedInstanceState) ; 
setContentView(R.layout.login); 
loginButton = (Button) findViewById (R.id.loginButton); 
List<String> list = new ArrayList<String>(); 
list.add ("随便 看 看 "); 
list.add ("推荐 用 户 "); 
list.add ("热门 转发 ") ; 
listView = (ListView) findViewById(R.id.listView) ; 
loginThread = new Thread (this); 


handler = new Handler () { 

/11 代表 登录 成 功 ，0 代表 登录 失败 

public void handleMessage (Message msg) { 

loginDialog.cancel(); 

switch (msg.what) { 
case 1: 
Toast.makeText(LoginActivity.this, "登录 成 功 "，3000) .show (); 
break; 

case 0: 
Toast.makeText(LoginActivity.this, "GAM", 3000).show(); 
break; 
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listView.setAdapter (new LoginListAdapter (this,list)); 
loginButton.setOnClickListener (new OnClickListener () { 
public void onClick(View v) { 

loginDialog = new ProgressDialog(LoginActivity.this) ; 
loginDialog.setProgressStyle (ProgressDialog.STYLE SPINNER) ; 
loginDialog. setMessage ("登录 服务 器 ") ; 
loginDialog.show(); 
loginThread.start(); 


He 

} 

public void run() { 
Log.e("loginThread","start"); 

Weibo weibo = new Weibo("XXX8sina.com","XXX");  ”// 新 浪 微 博 用 户 名 和 密码 
weibo.setHttpConnectionTimeout (5000); 
Message msa = new Message(); 
tty i 
User user = weibo.verifyCredentials (); 

// 该 方法 会 请 求 新 浪 微 博 服务 器 返回 Ison 对 象 

msa.what=1; 
} catch (WeiboException e) { 
msa.what=0; 
} 

} 

} 


12.5.4 ”实现 OAuth 认 证 


OAuth 协议 为 用 户 资源 的 授权 提供 了 一 个 安全 的 、 开 放 而 又 简易 的 标准 。 与 以 往 的 授 
权 方 式 不 同 之 处 是 OAuth 的 授权 不 会 使 第 三 方 触及 到 用 户 的 账号 信息 (如 用 户 名 与 密码 )， 
即 第 三 方 无 须 使 用 用 户 的 用 户 名 与 密码 就 可 以 申请 获得 该 用 户 资源 的 授权 ， 因 此 OAuth 是 
安全 的 。 

新 浪 微 博 为 了 实现 自身 的 安全 性 ， 采 用 了 OAuth 协议 认证 方式 。 虽 然 下 面 的 一 段 代 码 
比较 简单 ， 但 是 实现 了 新 浪 微 博 的 OAuth 认证 。 


System. setProperty ("weibo4j.oauth.consumerKey", Weibo.CONSUMER KEY); 
System.setProperty ("weibo4j.oauth.consumerSecret", 
Weibo.CONSUMER SECRET); 
Weibo weibo = new Weibo(); 
// set callback url, desktop app please set to null 
// http://callback url?oauth token-xxx&oauth verifier-xxx 
//1. 根 据 app key 第 三 方 应 用 向 新 浪 获取 requestToken 
RequestToken requestToken = weibo.getOAuthRequestToken(); 
System.out.println("1....... Got request token 成 功 "); 
System.out.println("Request token: "+ requestToken.getToken()); 
System.out.println("Request token secret: "+ requestToken.getTokenSecret () ) ; 
AccessToken accessToken = null; 


//2. 用 户 从 新 浪 获 取 verifier code, WR Android 或 Iphone 应 用 ， 可 以 callback 


- 
0B & 12$ ££ Android 中 开发 移动 微 博 应 三 
=json&userId=xxs&password=XXX 
System.out.println("Open the following URL and grant access to your account:"); 
System.out.println(requestToken.getAuthorizationURL()); 
BareBonesBrowserLaunch.openURL (requestToken.getAuthorizationURL ()); 
13 .用 户 输 入 验证 码 授权 信任 第 三 方 应 用 
BufferedReader br = new BufferedReader (new InputStreamReader (System.in)); 
while (null —- accessToken) ( 
System.out.print("Hit enter when it's done.[Enter]:"); 
String pin = br.readLine(); 
System.out.println("pin: " + br.toString()); 
try{ 
//4. 通 过 传递 requestToken 和 用 户 验证 码 获取 AccessToken 
accessToken = requestToken.getAccessToken (pin); 
) catch (WeiboException te) ( 
if(401 == te.getstatusCode())( 
System.out.println("Unable to get the access token."); 
}else{ 
te.printStackTrace (); 
} 
} 
} 
System.out.println("Got access token."); 
System.out.println("Access token: "+ accessToken.getToken()); 
System.out.println("Access token secret: "+ accessToken.getTokenSecret () ) ; 
// 使 用 AccessToken 来 操作 用 户 的 所 有 接口 
/* Weibo weibo-new Weibo(); 
以 后 就 可 以 用 下 面 accessToken 访问 用 户 的 资料 了 
* weibo.setToken (accessToken.getToken () ，accessToken.getTokenSecret () ) ; 
// 发 布 微 博 
Status status = weibo.updateStatus ("test message6 "); 
System.out.println("Successfully updated the status to [" 
+ status.getText() + "]."); 
try { 
Thread. sleep (3000); 
} catch (InterruptedException e) { 
// TODO Auto-generated catch block 
e.printStackTrace(); 
ey 
System.exit (0); 
} catch (WeiboException te) { 
System.out.println("Failed to get timeline: " + te.getMessage()); 
System.exit( -1); 
} catch (IOException ioe) { 
System.out.println("Failed to read the system input."); 
System.exit( -1); 
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流量 统计 系统 


在 Android 网 络 项 目 编程 应 用 中 ， 流 量 统计 是 最 常见 的 一 
种 应 用 。 通 过 流量 统计 功能 ， 可 以 及 时 了 解 手 机 使 用 网 络 流量 
的 状况 。 在 本 章 的 内 容 中 ， 将 详细 讲解 在 Android 系统 中 实现 
流量 统计 功能 的 基本 知识 ， 介 绍 了 实现 思路 ， 为 步 入 本 书后 面 
知识 的 学 习 打下 基础 。 
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13.1 流 鲁 统计 基础 


流量 统计 功能 十 分 重要 。 通 过 流量 统计 可 以 及 时 获取 我 们 使 用 过 的 网 络 流量 ， 避 免 超 
出 各 种 包月 流量 的 限制 。 本 节 将 简要 讲解 在 Android 中 实现 流量 统计 的 基本 知识 。 


13.1.1 TrafficStats 类 


对 于 Android 流量 统计 功能 来 说 ， 从 2.2 版 中 开始 加 入 了 TrafficStats 类 ， 通 过 此 类 可 
以 轻松 获取 Android 手机 的 流量 。 在 具体 实现 时 ，TrafficStats 类 是 通过 读 取 Linux 提供 的 
文件 对 象 系统 类 型 的 文本 进行 解析 的 。 在 android.net.TrafficStats 类 中 提供 了 多 种 静态 方 
法 ， 通 过 这 些 方法 可 以 直接 调用 获取 流量 信息 ， 返 回 类 型 均 为 long 型 ， 如 果 返 回 “-1”， 
则 代表 UNSUPPORTED， 即 当前 设备 不 支持 统计 。 

TrafficStats 类 中 的 统计 包括 所 有 网 络 接口 、Mobile 接口 和 UID 网 络 接口 的 字 节 发 送 和 
接收 ， 以 及 网 络 数据 包 的 发 送 和 接收 等 。 其 继承 关系 如 下 : 

public class TrafficStatsextends Object 

java.lang.Object 

android.net.TrafficStats 

功能 : 获取 通过 Mobile 接口 发 送 的 数据 包 总 数 。 

返回 值 : 数据 包 总 数 。 如 果 本 设备 不 支持 统计 ， 将 返回 UNSUPPORTED。 

1. TrafficStats 类 的 常量 

public static final int UNSUPPORTED: 返回 值 表示 该 设备 不 支持 统计 。 常 量 值 

— (Oxffffffff) . 

2. TrafficStats 类 的 公共 方法 

TrafficStats 类 的 公共 方法 如 下 。 

Q public static long getMobileRxBytes(): 获取 通过 Mobile 接口 接收 到 的 字 节 总 数 ， 
不 包含 Wi-Fi。 返 回 值 是 字 节 总 数 。 如 果 本 设备 不 支持 统计 ， 将 返回 
UNSUPPORTED. 

Q public static long getMobileRxPackets(): 获取 通过 Mobile 接口 接收 到 的 数据 包 总 
数 。 返 回 值 是 数据 包 总 数 。 如 果 本 设备 不 支持 统计 ， 将 返回 UNSUPPORTED. 

Q public static long getMobileTxBytes(): 获取 通过 Mobile 接口 发 送 的 字 节 总 数 ， 返 
回 值 是 字 节 总 数 。 如 果 本 设备 不 支持 统计 ， 将 返回 UNSUPPORTED. 

Q public static long getMobileTxPackets(): 获取 通过 Mobile 接口 发 送 的 数据 包 总 
数 ， 返 回 值 是 数据 包 总 数 。 如 果 本 设备 不 支持 统计 ， 将 返回 UNSUPPORTED。 

Q public static long getTotalRxBytes(): 获取 通过 所 有 网 络 接口 接收 到 的 字 节 总 数 ， 
faz Mobile 和 Wi-Fi 等 。 返 回 值 是 字 节 总 数 。 如 果 本 设备 不 支持 统计 ， 将 返回 
UNSUPPORTED. 


mu 
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Q public static long getTotalRxPackets(): 获取 通过 所 有 网 络 接 口 接 收 到 的 数据 包 总 
数 ， 包 含 Mobile 和 Wi-Fi 等 。 返 回 值 是 数据 包 总 数 。 如 果 本 设备 不 支持 统计 ， 将 
返回 UNSUPPORTED. 

Q public static long getTotalTxBytes(): 获取 通过 所 有 网 络 接口 发 送 的 字 节 总 数 ， 包 
?r Mobile 和 Wi-Fi 等 。 返 回 值 是 字 节 总 数 。 如 果 本 设备 不 支持 统计 ， 将 返 加 
UNSUPPORTED. 

Q public static long getTotalTxPackets(): 获取 通过 所 有 网 络 接 口 发 送 的 数据 包 总 数 ， 
包含 Mobile 和 Wi-Fi 等 。 返 回 值 是 数据 包 总 数 。 如 果 本 设备 不 支持 统计 ， 将 返 
UNSUPPORTED. 

Q public static long getUidRxBytes(int uid): 获取 通过 UID 网 络 接口 接收 到 的 字 节 
数 ， 统 计 包 含 所 有 网 络 接口 。 参 数 uid 表示 待 检查 的 进程 的 UID。 返 回 值 是 字 节 数 。 

Q public static long getUidTxBytes (int uid): 获取 通过 UID 网 络 接口 发 送 的 字 节 数 ， 
统计 包含 所 有 网 络 接口 。 参 数 uid 表示 待 检查 的 进程 的 UID。 返 回 值 是 字 节 总 
数 ， 如 果 本 设备 不 支持 统计 ， 将 返回 UNSUPPORTED. 

GER: X TrafficStats 通常 通过 以 下 三 个 方法 查看 具体 流量 。 
Q getMobileRxBytes() 
Q getTotalRxBytes() 
OQ getUidRxBytes()?X getUidTxBytes() 
Android 的 流量 统计 功能 是 通过 ndk 调用 以 下 文件 实现 的 。 
Q “发送 包 : /sys/class/neUrmnetO/statistics/tx packets. 
口 接收 包 : /sys/class/net/rmnet0/statistics/rx_packets. 
口 发 送 字 节 : /sys/class/net/rmnet0/statistics/tx_bytes。 
Q 接收 字 节 : /sys/class/net/rmnet0/statistics/rx_bytes 或 /proc/self/net/dev。 
在 具体 测试 时 会 发 现 ， 各 进程 getUidRxBytes 的 值 总 与 MobileRxBytes 不 一 
致 。 经 过 查看 getUidRxBytes() 和 getUidTxBytes()&] native( 本 地 ) 代 码 后 ， 会 
发 现 此 方法 通过 读 取 /proc/uid_stat/%d/tcp_rcv 和 /proc/uid stat/?ed/tep snd 文件 
来 获取 流量 ， 其 中 %d 为 进程 UID。 这 两 个 文件 为 非 标 准 Linux 内 核 文件 ， 
由 Android 内 核 层 /kernel/net/Socket.c 的 函数 sock sendmsg() 负 责 写 入 。 用 
户 层 套 接 字 通 信 在 内 核 层 最 终 会 调用 此 函数 ， 包 括 本 地 套 接 字 和 网 络 套 接 
字 。 所 以 根据 TrafficStats.getUidRxBytes() 或 getUidTxBytes0 获 取 的 流量 ， 不 
但 包括 了 网 络 流量 ， 而 且 也 包括 了 本 地 流量 。 
而 MobileRxBytes() 读 取 的 是 如 下 数据 。 
口 sys/class/net/rmnetO/statistics/rx_bytes 
DO sys/class/net/pppO/statistics/rx bytes 


n 


13.1.2 Android 流 量 统计 的 基本 思路 


在 Android 2.2 版 本 以 后 ， 主 要 使 用 类 TrafficStats 中 的 方法 来 实现 流量 统计 。 由 于 在 
应 用 项 目 中 需要 用 到 监控 各 个 应 用 的 流量 ， 所 以 基本 思路 是 : 先 获 取 手 机 中 所 有 具有 联网 
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权限 的 应 用 ， 并 且 以 列表 形式 显示 出 来 ， 然 后 选择 相应 的 应 用 ， 即 可 对 其 进行 流量 监控 。 
这 里 用 到 的 便 是 方法 getUidRxBytes(int uid) 和 方法 getUidTxBytes(int uid)。 在 获取 手机 中 所 
有 具有 联网 权限 的 应 用 之 前 ， 把 手机 中 所 有 应 用 的 流量 使 用 情况 都 显示 了 出 来 。 事 实证 
明 ， 连 拨号 器 操作 都 会 耗费 流量 。 由 此 可 见 ， 用 这 两 个 类 方法 获取 的 流量 包括 本 地 流量 ， 
所 以 就 会 出 现 连 没有 联网 权限 的 应 用 都 发 送 和 接收 字 节 数 这 种 情况 。 

下 面 是 一 段 根据 上 述 思路 实现 流量 监控 的 代码 。 


public void dingshi (){ 


mdb.openDB () ; // 打 开 数 据 库 


runnableapp-new Runnable(){ // 线 程 对 象 
GOverride 
public void run() ( 
while (flag==0) {// 用 于 停止 线程 时 的 判断 
try ( 
Thread.sleep (1000); //fj 1000ms 进行 流量 监控 
) catch (InterruptedException e) ( 
// TODO Auto-generated catch block 
e.printStackTrace(); 
) 
int i-0; 
Log.v("app", "id----»"«Thread.currentThread().getId()); 
tryt 
for (i=0;i<listuser.size();i++) {//listuser 想 要 监控 的 
应 用 ， 只 要 列表 不 再 重新 选择 ， 则 获取 应 用 的 顺序 一 定 
Log.v ("app", "开始 "+Thread.currentThread () -getId()); 
uid-Integer.parseInt (listuser.get(i)); 
// 列 表 中 第 工 个 选择 的 应 用 的 uid 
appinfo-listappinfo.get (i); 


Calendar calendar - Calendar.getInstance(); 
int month-calendar.get (Calendar.MONTH) +1; 
int day-calendar.get(Calendar.DAY OF MONTH); 
int hour-calendar.get (Calendar.HOUR OF DAY); 
int minute-calendar.get (Calendar.MINUTE); 
int second-calendar.get (Calendar.SECOND); 
float mill-calendar.get (Calendar.MILLISECOND); 
String time- calendar.get(Calendar.YEAR) + "年 " 
+ month + "H" 
+ day + "H" 
+ hour + "Hj" 
+ minute + "4j" 
-seconde" fh" 
+mill+" 毫 秒 "; 
time02[i]=day*24*60*60+hour*60*60+minute*60+second+mil1/1000; 
// 单 位 是 秒 ， 新 获取 的 时 间 ， 肯 定 大 于 前 面 获取 的 时 间 


System.out.println ("现在 的 时 间 "+i+"--->"+time02[i]); 
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System.out.println ("之 前 的 时 间 "+i+"--->"+time01[i]); 


recv[i]-TrafficStats.getUidRxBytes (uid); 

if(recv[i]>0) { 

recv[i]-recv[i]/(1024*1024) ;// 单 位 为 MB 

Jelset 

recv[i]-0; 

) 

tran[i]-TrafficStats.getUidTxBytes (uid); 

if(tran[i]»0)( 

tran[i]-tran[i]/(1024*1024); 

) 

else( 

tran[i]-0; 

) 

totalapp[i]=recv[i]+tran[i]; 
recvrate[i]=((recv[i]-recv01[i]) *1024*1024) / (time02[i]-time01[i]); 

// 单 位 为 B/s， 均 为 瞬时 速率 

tranrate[i]-((tran[i]-tran01[i])*1024*1024)/ (timeO2[i]-time01[i]); 

totalapprate[i]=((totalapp[i]- 
totalapp01[i])*1024*1024) / (time02[i]-time01[i]); 


System.out .println (appinfo+i+"---->" +" 接 收 速率 ---->" 

+recvrate[i]+ "发 送 速 率 ---->" + tranrate[i]+"total 

速率 ---->"+totalapprate[i]); 

System.out.println ("时 间 间 隔 "+i+"---->"+ (time02[i]- 
time01[i])); 


recv01[i]=recv [i] :// 给 全 局 变量 赋 新 值 
tran0l[i]-tran[i]; 
totalappOl[i]-totalapp[il; 

time01[i]-time02[i]; 


System.out.println("uid-" + uid +"---->"+ "recv=" 
+ recv[i]); 
System.out.println("uid-" + uid +"---->"+ "tran-" 


* tran[i]); 
System.out.println("uid-" + uid +"---->"+ totalapp[il); 
System.out.println("appinfo-" + appinfo ); 
try{ 
mdb.addTrafficData(time, appinfo, String.valueOf (uid), 
String.valueOf (tran[i]),String.valueOf (recv[i]) ,String. 
valueOf (totalapp[i]),String.valueOf (tranrate[i]), 
String.valueOf (recvrate[i]),String.valueOf 
(totalapprate[i])); 
}catch (Exception e) { 
System.out.println("--—-- »app 出 现 异 常 ") ; 
) 
Log.v("app", "4i#"+Thread.currentThread() .getId()); 
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}catch (Exception e) { 
System.out.println ("异常 "); 


n 
Thread AppThread = new Thread (runnableapp); 
AppThread. start (); 


13.1.3” 读 取 Linux 内 核 获 取 流 量 信息 


Android 手机 流量 信息 系统 是 基于 Linux 内 核 的 ， 记 录 在 /proc/self/net/dev 文件 中 。dev 
文件 的 格式 如 下 : 


Microsoft Windows XP [版 本 5.1.2600] 
(C) 版 权 所 有 1985-2001 Microsoft Corp. 
D:/Program Files/Java/sdk/android-sdk-windows/tools>adb shell 
# cd proc 
cd proc 
# cd net 
cd net 
# cat dev 
cat dev 
Inter-| Receive | Transmit face |bytes packets errs drop fifo frame 
compressed multicast|bytes packe ts errs drop fifo colls carrier 
compressed 
TTo:5050500910109502650/7050902020/1050 
eth0: 7069733 86239 0 0 0 0 0 0 12512463 741 79 000 00 0 
tunlo: 0 0 01070 0 0701070 0 0 1000710 
gre0:0000000000000000 € 


可 以 通过 读 取 dev 文件 来 获取 流量 信息 ， 例 如 下 面 的 代码 : 


import java.io.BufferedReader; 

import java.io.File; 

import java.io.FileInputStream; 
import java.io.FileNotFoundException; 
import java.io.FileOutputStream; 
import java.io.FileReader; 

import java.io.IOException; 

import java.util.Calendar; 

import org.apache.http.util.EncodingUtils; 
import android.app.Service; 

import android.content.Intent; 

import android.os.Handler; 

import android.os.IBinder; 
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import android.widget.Toast; 


public class mServicel extends Service 


t 


private Handler objHandler = new Handler(); 
private int intCounter = 0; 

private int mHour; 

private int mMinute; 

private int mYear; 

private int mMonth; 

private int mDay; 

private String mdate; 


final public String DEV FILE = "/proc/self/net/dev";// 系统 流量 文件 

String[] ethdata = ( "o", "o", "o", "o", "o", "o", "o", "o", "o", "o", "o", 
"o", "o", "o", "O", "O" }; 

String[] gprsdata = ( "o", "o", "o", "o", "o", "o", "o", " 
"o", "o", "o", "o", "O", "O" ); 

String[] wifidata = { "o", "o", "o", "o", "o", "o", "o", "o", "o", "o", 
"o", "Qu, "o", "o", "O", "O" ); 

String data = "0,0,0,0,0,0,0,0,0,0,0,0";// 对 应 on.txt 里 面 的 格式 


"Qn, "o", 


final String ETHLINE - " eth0"; 
// eth 是 以 太 网 信息 ，tiwlan0 是 Wi-Fi, rmnetO 是 GPRS 
final String GPRSLINE = "rmnet0"; 
// 转 载 时 此 处 为 tiwlan0， 但 发 现在 我 的 2.1 的 手机 上 为 wlano 
final String WIFILINE = " wlan0"; 
final String TEXT ENCODING - "UTF-8"; 
final public String ONPATH - "/data/data/zy.dnh/on.txt"; 
final public String LOGPATH = "/data/data/zy.dnh/log.txt"; 


private Runnable mTasks = new Runnable() 
t 
public void run()// 运行 该 服务 执行 此 函数 
t 
refresh(); 
intCounter++; 
// DisplayToast ("Counter:"+Integer.toString(intCounter) ); 
objHandler.postDelayed(mTasks, 3000);// f 3000ms 执行 一 次 


} 

i 

@override 

public void onStart (Intent intent, int startId) 

{ 
// TODO Auto-generated method stub 
objHandler.postDelayed(mTasks, 0); 
super.onStart (intent, startId); 

} 

@override 
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public void onCreate() 
t 


// TODO Auto-generated method stub 
super.onCreate(); 


@override 

public IBinder onBind(Intent intent) 

ul 
// TODO Auto-generated method stub 
return null; 


GOverride 

public void onDestroy() 

t 
// TODO Auto-generated method stub 
ge c 
objHandler.removeCallbacks (mTasks); 
super.onDestroy(); 


public void DisplayToast(String str) 


t 
Toast.makeText(this, str, Toast.LENGTH SHORT).show(); 


public void readdev() 
{ 
FileReader fstream = null; 
try { 
fstream = new FileReader (DEV FILE); 
} 
catch (FileNotFoundException e) { 
DisplayToast ("Could not read " + DEV FILE); 


BufferedReader in = new BufferedReader (fstream, 500); 

String line; 

String[] segs; 

String[] netdata; 

int count = 0; 

int k; 

int j; 

try { 

while ((line = in.readLine()) != null) { 

segs = line.trim().split(":"); 
if (line.startsWith (ETHLINE) ) 
{ 


netdata = segs[1]-.trim().split(" "); 
for (k = 0, j = 0; k < netdata.length; k++) 
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if (netdata[k].length() > 0) 
{ 


ethdata[j] netdata[k]; 
jtt; 
} 
I} 
} 
else if (line.startsWith (GPRSLINE) ) 
ü 
netdata = segs[1]-.trim().split(" "); 
for (k = 0, j = 0; k < netdata.length; k++) 
{ 
if (netdata[k].length() > 0) 
{ 
gprsdata[j] = netdata[k]; 
j++; 
} 
} 
} 
else if (line.startsWith (WIFILINE) ) 
{ 
netdata = segs[1].trim().split(" "); 
for (k = 0, j = 0; k < netdata.length; k++) 
{ 
if (netdata[k].length() > 0) 
{ 
wifidata[j] = netdata[k]; 
j++; 
} 
} 
} 
count++; 


fstream.close(); 

) 

catch (IOException e) ( 
DisplayToast (e.toString()); 


public String getinfo(String path) 
{ 
File file; 
String str = > 
FileInputStream in; 
try ( 
// 打开 文件 file 的 InputStream 
file new File(path); 
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in = new FileInputStream(file); 

// 将 文件 内 容 全 部 读 入 到 byte 数组 

int length = (int) file.length(); 

byte[] temp - new byte[length]; 

in.read(temp, 0, length); 

// 将 byte 数组 用 uTF-8 编码 并 存 入 display 字符 串 中 

str = EncodingUtils.getString(temp, TEXT ENCODING); 
// 关闭 文件 file 的 InputStream 

in.close(); 


} 
catch (IOException e) { 
DisplayToast (e.toString()); 
} 
return str; 
} 


public void writefile(String str, String path) 
t 
File file; 
FileOutputStream out; 
try ( 
// 创建 文件 
file = new File(path); 
file.createNewFile(); 
// 打开 文件 file 的 OutputStream 
out = new FileOutputStream(file); 
String infoToWrite - str; 
// 将 字符 串 转换 成 byte 数组 写 入 文件 
out.write(infoToWrite.getBytes()); 
// 关闭 文件 file 的 OutputStream 
out.close(); 
) catch (IOException e) ( 
// 将 出 错 信息 打印 到 Logcat 
DisplayToast (e.toString()); 


} 


public void refresh () 


{ 
readdev();// 读 取 本 次 开机 之 后 直到 当前 系统 的 总 流量 


data = ethdata[0] + "," + ethdata[1] + "," + ethdata[8] + "," 
+ ethdata[9] + "," 


+ gprsdata[0] + "," + gprsdata[1] + "," + gprsdata[8] + "," 
+ gprsdata[9] + "," 
+ wifidata[0] + "," + wifidata[1] + "," + wifidata[8] + "," 
+ wifidata[9]; 
String onstr = getinfo(ONPATH) ; // 读 取 on .txt 记录 到 onstr 里 
String ondata[] = onstr.split(","); // 将 onstr 各 项 分 离 放 到 ondata 里 
// 计算 增 量 


int[] delt 
delta[0] 
delta[1] = 
delta[2] = 
delta[3] = 
delta[4] = 
delta[5] = 
delta[6] = 
delta[7] = 
delta[8] = 
delta[9] = 


a = new int[12]; 


= Integer.parseInt (ethdata[0]) 


Integer.parseInt (ethdata[1]) 
Integer.parseInt (ethdata[8]) 
Integer.parseInt (ethdata[9]) 
Integer .parseInt (gprsdata[0]) 
Integer .parseInt (gprsdata[1]) 
Integer.parseInt (gprsdata[8]) 
Integer.parseInt (gprsdata[9]) 
Integer.parseInt (wifidata[0]) 
Integer.parseInt (wifidata[1]) 
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- Integer.parseInt (ondata[0]); 
- Integer.parseInt (ondata[1]); 
- Integer.parseInt (ondata[2]); 
- Integer.parseInt (ondata[3]) ; 
- Integer.parseInt (ondata[4]); 
- Integer.parseInt (ondata[5]); 
- Integer.parseInt (ondata[6]); 
- Integer.parseInt (ondata [7]) ; 
- Integer.parseInt (ondata[8]); 
- Integer.parseInt (ondata[9]); 


delta[10] = Integer.parseInt (wifidata[8])- Integer.parseInt (ondata[10]) ; 
delta[11] = Integer.parseInt (wifidata[9])- Integer.parseInt (ondata[11]) ; 


// 读 取 1og.txt 
// 获取 当前 时 间 


ndar c = Calendar.getInstance(); 


final Cale 
mYear = c. 
mMonth = c 
mDay = c.g 
mHour = c. 
mMinute = 


get (Calendar. YEAR) ; 

.get (Calendar.MONTH) + 1; 
et (Calendar.DAY OF MONTH); 
get (Calendar.HOUR OF DAY); 
c.get (Calendar .MINUTE) ; 


// 获取 当前 年 份 

// 获取 当前 月 份 

// 获取 当前 月 份 的 日 期 号 码 
// 获取 当前 的 小 时 数 

// 获取 当前 的 分 钟 数 


mdate = mYear + "-" + mMonth + "-" + mDay; 


String tex 
String[] 1 


String today = line[line.length - 1]; 


t = getinfo (LOGPATH) ; // Xf 1og.txt 的 内 容 读 到 text 字符 串 中 


ine = text.split("/n"); 


String[] beToday - today.split(","); 


// 检查 文件 最 后 一 行 是 否 为 今天 的 流量 记录 信息 


if (!beToday[0].equals (mdate) 
// 如 果 文 件 只 有 一 行 ， 表 明 目 前 日 志 为 空 ， 将 当前 日 期 加 入 
// 判断 今日 流量 是 否 已 经 记录 ， 如 果 今日 流量 没有 记录 


text = 
writef 
line = 


// 获得 今日 已 记录 流量 


text + mdate + ",0,0,0,0,0,0,0,0,0,0,0,0/n"; 


ile(text, LOGPATH); 
text.split("/n"); 


today = line[line.length - 1];// 获得 今日 已 记录 流量 


beToda 


) 
int i; 


y = today.split(","); 


// 处 理 今 日 流量 
int[] newTodaydata = new int[12];// 表示 今日 流量 
String newtoday = mdate; 


for (i = 0 
t 
newToda 


; i <= 11; i++) 


ydata[i] = Integer.parseInt (beToday[i + 1]) + delta[i]; 


newtoday = newtoday + "," + newTodaydata[i]; 


} 


newtoday = newtoday + "/n"; 
String[] beTotal = line[0].split(","); 
int[] newTotaldata = new int[12];// 表示 总 流量 数值 
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// 更 新 第 一 行 

String newtotal = "total"; 
for (i = 0; i <= 11; i++) 
{ 


newTotaldata[i] = Integer.parseInt (beTotal[i + 1]) + 
deltalil;// 总 流量 数值 rdelta[i] 更 新 

newtotal = newtotal + "," + newTotaldata[i]; 
1 
newtotal = newtotal + "/n"; 
// 处 理 中 间 不 变 的 部 分 
String before = "";// before 为 之 前 的 从 第 1 行 到 昨天 的 流量 记录 
for (i = 1; i <= line.length = 2; i++) 

before = before + line[i] + "/n"; // 代表 中 间 不 变 的 部 分 
String newlog = newtotal + before + newtoday; 
writefile(data, ONPATH); // 更 新 流量 记录 
writefile(newlog, LOGPATH); // 更 新 log*/ 


13.2 基于 防火 墙 的 流 鲁 统计 


在 本 节 的 内 容 中 ， 将 通过 几 段 演示 代码 的 实现 过 程 ， 来 讲解 实现 基于 防火 墙 的 
Android 流量 统计 的 应 用 过 程 。 

(1) BroadcastReceiver 模块 的 实现 ， 用 于 监听 开机 信息 并 初始 化 和 启动 服务 。 具 体 代 码 
如 下 : 


package zy.dnh; 
import java.io.File; 
import java.io.FileOutputStream; 
import java.io.IOException; 
import android.content.BroadcastReceiver; 
import android.content.Context; 
import android.content.Intent; 
import android.widget.Toast; 
public class getpowerinfo extends BroadcastReceiver( 
FileOutputStream out; 
final public String ONPATH = "/data/data/zy.dnh/on.txt"; 
@override 
public void onReceive (Context context, Intent intent) { 
// TODO Auto-generated method stub 
if (intent.getAction() .equals(Intent.ACTION BOOT COMPLETED) ) { 
Intent bootActivityIntent=new Intent (context,mServicel.class) ; 
// 启 动 服务 
bootActivityIntent.addFlags (Intent.FLAG ACTIVITY NEW TASK); 
writefile("0,0,0,0,0,0,0,0,0,0,0, 0", ONPATH) ; 
context.startService (bootActivityIntent); 
Toast.makeText (context, "Netcounter service has been 
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lauched", Toast.LENGTH LONG) .show(); 
Api.applySavedIptablesRules (context，false) ;// 应 用 防火 墙 规则 
Toast.makeText (context, "Wall rules have been lauched", 
Toast.LENGTH LONG).show(); 


} 
public void writefile(String str,String path ) 
{ 
File file; 
ery 
// 创 建文 件 
file = new File(path); 
file.createNewFile(); 
/ 3E XT file 的 OutputStream 
out - new FileOutputStream(file); 
String infoToWrite = str; 
// 将 字符 串 转换 成 byte 数组 写 入 文件 
out .write (infoToWrite.getBytes()); 
// 关 闭 文件 file 的 OutputStream 
out.close(); 
) catch (IOException e) ( 
// 将 出 错 信息 打印 到 Logcat 
} 


(2) mServicel 模块 的 实现 ， 此 模块 是 后 台 服 务 ， 用 于 维护 流量 日 志 。 具 体 代码 如 下 : 


public class mServicel extends Service 
{ 

private Handler objHandler = new Handler(); 

private int intCounter-0; 

private int mHour; 

private int mMinute; 

private int mYear; 

private int mMonth; 

private int mDay; 

private String mdate; 

final public String DEV FILE = "/proc/self/net/dev";// 系 统 流量 文件 

String[] ethdata={"0", "0", "0", "0", "0", "0", "gn, non, no", "gn, non, "o", 
"Qn, "on, "o", nom; 

String[] gprsdata-("0","Q","Q", "0", "Qn, "0", "Qn, ng", "0", "gn, "on, "on, 
"Qn, "on, "o", mom), 

String[] wifidata-("0","Q","Q", "0", "0", "gn, "0" "QO" "on, MQW WoW "Qn, 
"Qn, "on, "o", mom); 

String data-"0,0,0,0,0,0,0,0,0,0,0,0"; // 对 应 on .txt 里 面 的 格式 

final String ETHLINE-" eth0"; // 以 太 网 信息 所 在 行 

final String GPRSLINE="rmnet0"; 

final String WIFILINE-"tiwlan0"; 


final String TEXT ENCODING 


"UTF-8"; 


final public String ONPATH = "/data/data/zy.dnh/on.txt"; 
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final public String LOGPATH = "/data/data/zy.dnh/log.txt"; 


(3) 应 用 Iptable 规则 模块 的 实现 ， 通 过 运行 Iptable 脚本 来 实现 Iptable 规则 。 具 体 代 
码 如 下 : 


private static boolean applyIptablesRulesImpl(Context ctx, List<Integer> 
uids, boolean showErrors) ( 
if (ctx — null) ( 
return false; 


) 
final SharedPreferences prefs - 
ctx.getSharedPreferences (PREFS NAME, 0); 
final boolean whitelist - prefs.getString(PREF MODE, 
MODE WHITELIST).equals (MODE WHITELIST); 
boolean wifi = false; // Wi-fi selected ? 
final String itfs - prefs.getString(PREF ITFS, ITF 3G); 
String itfFilter; 


if (itfs.indexOf("|") !- -1) ( 
itfFilter = ""; // Block all interfaces 
wifi = true; 

) else if (itfs.indexOf(ITF 3G) != -1) ( 


itfFilter = "-o rmnet+";; 
// Block all rmnet interfaces 
) else ( 
itfFilter = "-o tiwlan+";; 
// Block all tiwlan interfaces 
wifi = true; 
} 
final StringBuilder script = new StringBuilder (); 
try { 
int code; 
script.append("iptables -F || exit/n"); 
final String targetRule = (whitelist ? "ACCEPT" : "REJECT"); 
if (whitelist && wifi) { 
// When "white listing" Wi-fi, we need ensure that the dhcp 
and wifi users are allowed 
int uid = android.os.Process.getUidForName ("dhcp") ; 
if (uid != -1) script.append("iptables -A OUTPUT " 
+ itfFilter + " -m owner --uid-owner " + uid + " -j 
ACCEPT || exit/n"); 
uid = android.os.Process.getUidForName ("wifi") ; 
if (uid != -1) script.append("iptables -A OUTPUT " + itfFilter 
+ " -m owner --uid-owner " + uid + " -j ACCEPT || exit/n"); } 
for (Integer uid : uids) { 
script.append("iptables -A OUTPUT " + itfFilter 
+ =m owner —-uid-owner T + mid p T-j mor 
targetRule + " || exit/n"); 
} 
if (whitelist) { 
script.append("iptables -A OUTPUT " + itfFilter + " -j 
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REJECT || exit/n"); 
} 
StringBuilder res = new StringBuilder (); 
code = runScriptAsRoot (script.toString(), res); 
if (showErrors && code != 0) { 
String msg = res.toString(); 
Log.e("DroidWall", msg); 
// Search for common error messages 
if (msg.indexOf ("Couldn't find match 'owner'") != -1 || 
msg.indexOf ("no chain/target match") != -1) { 
alert(ctx, "Error applying iptables rules./nExit code: " + 
code + "/n/n" +"It seems your Linux kernel was not 
compiled with the netfilter /"owner/" module enabled, 
which is required for Droid Wall to work properly./n/n" 
+ "You should check if there is an updated version of 
your Android ROM compiled with this kernel module."); 
) else ( 
// Remove unnecessary help message from output 
if (msg.indexOf("/nTry 'iptables -h' or 'iptables --help' for 
more information.") !- -1) ( 
msg - msg.replace("/nTry 'iptables -h' or 'iptables --help' for 
more information.", ""); 
} 
// Try 'iptables -h' or 'iptables --help' for more information. 
alert(ctx, "Error applying iptables rules. Exit code: " + code + 
"/n/n" + msg.trim()); 
} 
} else { 
return true; 
} 
} catch (Exception e) { 
if (showErrors) alert(ctx, "error refreshing iptables: " + e); 
} 
return false; 


13.3 适用 Android 系统 的 通用 流量 
统计 函数 


为 了 便于 读者 使 用 TrafficStats 类 ， 笔 者 编写 了 几 个 流量 统计 函数 供 读者 使 用 。 这 些 函 
数 保存 在 文件 daima 13 TrafficStatsLL java 中 ， 具 体 代 码 如 下 : 


package com.AAJM; 


import java.io.ByteArrayOutputStream; 
import java.io.File; 
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import java.io.FileInputStream; 
import java.io.FileNotFoundException; 
import java.io.IOException; 

import java.util.regex.Matcher; 
import java.util.regex.Pattern; 
import android.util.Log; 

public class TrafficStatsLL ( 

[** 

* 获取 网 络 流量 信息 

* 利用 读 取 系 统 文件 的 方法 来 获取 网 络 流量 

* 主要 意义 在 于 可 以 应 用 于 2.2 以 前 的 没有 提供 Trafficstats 接口 的 版 本 
cof 


public static String readInStream(FileInputStream inStream) { 

try { 

ByteArrayOutputStream outStream = new ByteArrayOutputStream(); 
byte[] buffer = new byte[1024]; 

int length = -1; 
while ( (length = inStream.read(buffer)) != -1 )( 
outStream.write (buffer, 0, length); 

} 

outStream.close(); 

inStream.close(); 

return outStream.toString(); 

) catch (IOException e) { 

Log.i("FileTest", e.getMessage()); 

} 

return null; 


} 
// 获 取 手 机 26/36 的 下 载 流量 
public static long getMobileRxBytes () 
{ 
long ReturnLong=0; // 查 询 到 的 结果 
try { 
File file = new File("/proc/net/dev"); 
FileInputStream inStream = new FileInputStream(file); 
String a-readInStream(inStream); 
int startPos=a.indexOf ("rmnet0:"); 
a-a.substring(startPos); 
Pattern p-Pattern.compile(" \\d+ "); 
Matcher m-p.matcher (a); 
while (m.find())( 
ReturnLong-Long.parseLong (m.group().trim()); 
break; 
} 


) catch (FileNotFoundException el) ( 
el.printStackTrace(); 

} 

return ReturnLong; 
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// 获 取 手机 2G/3G 的 上 传 流量 
public static long getMobileTxBytes () 
{ 
long ReturnLong=0; // 查 询 到 的 结果 
EEY A 
int count=0; // 返 回 结果 时 的 计数 器 


File file = new File("/proc/net/dev"); 
FileInputStream inStream - new FileInputStream(file); 
String a=readInStream(inStream) ; 

int startPos=a.indexOf ("rmnet0:"); 
a-a.substring(startPos); 

Pattern p-Pattern.compile(" \\d+ "); 
Matcher m-p.matcher (a); 

while (m.find()) { 

if (count==8) 


{ 
ReturnLong-Long.parseLong (m.group().trim()); 


break; 


) 
counttt; 


) catch (FileNotFoundException el) ( 
el.printStackTrace(); 


} 
return ReturnLong; 


} 
// 获 取 手 机 Wi-Fi 的 下 载 流量 
public static long getWifiRxBytes() 


t 
long ReturnLong-0; // 查 询 到 的 结果 
try { 
File file = new File("/proc/net/dev"); 
FileInputStream inStream = new FileInputStream(file); 
String a=readInStream(inStream) ; 
int startPos=a.indexOf ("wlan0:"); 
a=a.substring(startPos) ; 
Pattern p-Pattern.compile(" \\d+ "); 
Matcher m=p.matcher (a) ; 
while (m.find()) { 
ReturnLong-Long.parseLong (m.group().trim()); 
break; 


) catch (FileNotFoundException el) ( 
el.printStackTrace(); 


È 
return ReturnLong; 
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// 获 取 手 机 Wi-Fi 的 上 传 流量 / 
public static long getWifiTxBytes() 


t 


long ReturnLong-0; // 查 询 到 的 结果 

try í 
int count=0; // 返 回 结果 时 的 计数 器 
File file = new File("/proc/net/dev"); 
FileInputStream inStream - new FileInputStream(file); 
String a=readInStream(inStream) ; 
int startPos=a.indexOf ("wlan0:"); 
a=a.substring(startPos) ; 
Pattern p-Pattern.compile(" \\d+ "); 
Matcher m=p.matcher (a) ; 
while (m.find()) { 
if (count==8) 


{ 
ReturnLong-Long.parseLong (m.group().trim()); 


break; 
) 
count++; 
} 


} catch (FileNotFoundException el) { 
el.printStackTrace(); 


) 
return ReturnLong; 


) 
// 根 据 uid 获取 进程 的 下 载 流量 
public static long getUidRxBytes (int uid) 


{ 
long ReturnLong=0; // 查 询 到 的 结果 


try { 
String url-"/proc/uid stat/"+String.valueOf (uid)+"/tcp rcv"; 


File file - new File(url); 
FileInputStream inStream; 
if(file.exists()) 


t 
inStream - new FileInputStream(file); 


ReturnLong-Long.parseLong (readInStream(inStream) .trim()); 
} 
} catch (FileNotFoundException e) { 
// TODO Auto-generated catch block 


e.printStackTrace(); 


} 
//Log.i (url+" 文 件 并 不 存在 "," 可 能 原因 为 该 文件 在 开机 后 并 没有 上 过 网 ， 所 以 


没有 流量 记录 ") ; 


return ReturnLong; 


} 
// 根 据 uid 获取 进程 的 上 传 流量 
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public static long getUidTxBytes (int uid) 


t 
long ReturnLong-0; // 查 询 到 的 结果 


try { 
String url="/proc/uid_stat/"+String.valueOf (uid) +"/tcp_snd"; 


File file = new File(url); 
if (file.exists()) 


{ 
FileInputStream inStream = new FileInputStream(file) ; 


ReturnLong-Long.parseLong (readInStream(inStream) .trim()); 
) 
) catch (FileNotFoundException el) ( 
el.printStackTrace(); 


} 
return ReturnLong; 
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流量 监控 是 指 监控 当前 网 络 内 的 数据 流量 ， 帮 助 用 户 及 时 
了 解 系统 使 用 了 多 少数 据 。 在 任何 手机 中 ， 流 量 监控 系统 非常 
重要 ， 特 别 是 在 上 网 收费 的 时 代 ， 及 时 监控 自己 手机 的 网 络 流 
量 ， 才 能 在 用 手机 上 网 时 做 到 有 的 放 矢 。 本 章 将 通过 一 个 综合 
流量 系统 实例 的 实现 过 程 ， 讲 解 开发 一 个 大 型 流量 监控 系统 的 


具体 过 程 。 
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14.4 ”实现 流量 监控 功能 的 方式 


流量 监控 是 指 对 数据 流 进行 的 监控 ， 通常 包括 出 数据 、 入 数据 的 速度 和 总 流量 。 在 上 
网 时 用 流量 监控 软件 可 以 随时 获得 哪些 程序 正在 访问 互联 网 ， 以 及 它们 实时 的 下 载 速度 和 
上 传 速度 。 在 目前 计算 机 领域 中 ， 常 见 的 实现 流量 监控 功能 的 方式 有 以 下 三 种 。 

1. 用 微软 提供 的 API 接 口 进行 流量 监控 

这 是 很 常用 的 一 种 监控 方法 ， 利 用 微软 提供 的 APT 接口 可 以 很 容易 地 获得 流量 数据 ， 
但 是 这 种 方法 会 受 多 方面 因素 的 限制 ， 得 到 的 结果 很 有 可 能 不 准确 或 者 有 延迟 ， 甚 至 得 不 
到 结果 。 

此 类 方法 的 流量 监控 通常 安装 后 即 可 使 用 而 不 用 重启 电脑 。 

2. 用 底层 驱动 的 方式 获得 网 卡 数据 流量 

这 是 一 种 不 太 常 用 的 方法 ， 技 术 难度 较 高 ， 不 易 受 其 他 因素 的 影响 ， 获 得 的 信息 准 
确 、 无 延迟 、 兼 容 性 好 ， 而 且 很 容易 限制 被 监控 程序 的 流量 。 

此 类 方法 的 流量 监控 软件 在 安装 后 可 能 需要 重启 电脑 。 

3. 调用 Windows 中 的 组 件 获得 流量 数据 

调用 Windows 性 能 工具 获得 网 络 流量 ， 此 类 方法 不 常用 、 难 度 大 ， 而 且 仅仅 对 
Windows 7/Vista 系统 有 效 。 基 本 没有 软件 会 使 用 这 种 方法 。 

本 章 的 网 络 流量 防火 墙 系统 实例 采用 Android 开源 系统 技术 ， 利 用 Java 语言 和 Eclipse 
开发 工具 对 防火 墙 系统 进行 开发 。 同 时 给 出 详细 的 系统 设计 流程 、 部 分 界面 图 及 主要 功能 
效果 流程 图 。 


| 实例 | 功能 (| eme O 


开发 一 个 网 络 流量 防火 寺 

在 本 章 的 内 容 中 ， 还 对 开发 过 程 中 遇 到 的 问题 和 解决 方法 进行 详细 的 讨论 。 整 个 系统 
实例 集 允许 上 网 、 权 限 设置 、 系 统 帮助 等 功能 于 一 休 ， 在 Android 系统 中 能 独立 运行 。 在 
讲解 具体 编码 之 前 ， 先 简要 介绍 本 项 目的 产生 背景 和 项 目 意义 ， 为 后 面 的 系统 设计 及 编码 
做 准备 。 


14.2 系统 需求 分 析 


根据 项 目的 目标 ， 我 们 可 分 析出 系统 的 基本 需求 。 以 下 从 软件 设计 的 角度 来 描述 系统 
的 功能 ， 并 且 使 用 例 图 来 描述 。 系 统 的 功能 模块 ， 分 别 是 主 界面 、 控 制 界 面 、 帮 助 界面 、 
更 多 设置 。 整 个 系统 的 构成 模块 结构 如 图 14-1 所 示 。 
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(1) 系统 性 能 需求 
根据 Android 手机 系统 要 求 无 响应 时 间 为 5 秒 ， 所 以 就 有 如 下 性 能 要 求 。 


口 
a 
口 
口 
口 


邮箱 类 型 设置 
邮箱 收取 设置 
邮箱 发 送 设置 
邮箱 用 户 检查 
用 户 邮件 编辑 


(2) 运行 环境 需求 
口 “ 操 作 系统 : Android 手机 基于 Linux 操作 系统 。 
OQ MEARE: Android 2.3 以 上 版 本 。 
口 ” 开 发 环境 : Eclipse 3.5 ADT 0.95. 


=) nB&xx 


= 保存 规则 
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图 14-1 系统 构成 模块 


14.3 系统 需求 


: 程序 响应 时 间 最 长 不 能 超过 5 BD; 
: 程序 响应 时 间 最 长 不 能 超过 5 秒 ; 
: 程序 响应 时 间 最 长 不 能 超过 5 秒 ; 
: 程序 响应 时 间 最 长 不 能 超过 5 秒 ; 
: 程序 响应 时 间 最 长 不 能 超过 5 秒 。 


144 编写 布局 文件 


UI 布局 开发 是 Android 应 用 程序 的 主要 工作 之 一 。 本 流量 监控 项 目 包 括 两 方面 布局 ， 
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分 别 为 主 界面 布局 和 帮助 界面 布局 。 下 面 将 详细 讲解 这 两 部 分 布局 文件 的 具体 实现 过 程 。 


1441 主 界面 布局 文件 main.xml 
首先 编写 主 界面 文件 main xml， 系 统 执行 之 后 首先 显示 主 界面 ， 具 体 代码 如 下 ; 


<?xml version-"1.0" encoding="utf-8"?> 
<LinearLayout android:layout width-"fill parent" 
android:layout height-"fill parent" 
xmlns:android-"http://schemas.android.com/apk/res/android" 
android:orientation-"vertical" android:duplicateParentState="false"> 
«View android:layout width-"fill parent" android:layout height="1sp" 
android:background="#FFFFFFFE" /> 
<LinearLayout android:layout width-"fill parent" 
android:layout height-"wrap content" android:padding="8sp"> 
«TextView android:layout width-"wrap content" 
android:layout height-"wrap content" android:id- 
"@+id/label mode" 
android:text-"Mode: " android:textSize-"20sp" android:clickable- 
"true"></TextView> 
</LinearLayout> 
«View android:layout width="fill parent" android:layout height="1sp" 
android:background="#FFFFFFFE" /> 
<RelativeLayout android:layout width="fill parent" 
android:layout height-"wrap content" android:padding="3sp"> 
<ImageView android:layout width-"wrap content" 
android:layout height-"wrap content" android:id="@+id/img wifi" 
android:src="@drawable/eth wifi" android:clickable="false" 
android:layout alignParentLeft="true" android:paddingLeft="3sp" 
android: paddingRight="10sp"></ImageView> 
<ImageView android:layout width="wrap content" 
android:layout height="wrap content" android:id="@+id/img 3g" 
android:layout toRightOf="@id/img wifi" android:src= 
"@drawable/eth g" 
android: clickable="false"></ImageView> 
<ImageView android:layout width="wrap content" 
android:layout height-"wrap content" android: id="@+id/img download" 
android: src="@drawable/download" 
android:layout alignParentRight="true" 
android:paddingLeft-"22sp" android:clickable="false"></ImageView> 
<ImageView android:layout width="wrap content" 
android:layout height="wrap content" android:id="@+id/img upload" 
android: layout toLeftOf="@id/img download" android:src= 
"@drawable/upload" 
android:clickable="false"></ImageView> 
</RelativeLayout> 
<ListView android:layout width="wrap content" 
android:layout height="wrap content" android:id="@+id/listview"> 
</ListView> 
</LinearLayout> 
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在 上 述 代码 中 ， 将 整个 主 界面 划分 为 以 下 两 个 部 分 。 
Q LN: 显示 模式 和 网 络 类 型 ， 其 中 模式 分 为 黑 名 单 模式 和 白 名 单 模式 两 种 。 
口 下 部 分 : 列表 显示 了 某 种 模式 下 所 有 的 网 络 服务 ， 并 且 在 每 种 服务 前 面 显示 一 
复 选 框 控件 ， 通 过 该 控件 可 以 设置 菜 种 服务 启用 还 是 禁 
下 部 分 的 列表 功能 是 通过 文件 listitem.xml 实现 的 ， 具体 代码 如 下 : 


«?xml version-"1.0" encoding-"utf-8"?» 
«RelativeLayout 
xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" android:layout height- 
"fill parent"> 
<CheckBox android:layout width-"wrap content" 
android:layout height-"wrap content" android:id="@+id/itemcheck wifi" 
android:layout alignParentLeft="true"></CheckBox> 
<CheckBox android:layout width-"wrap content" 
android:layout height-"wrap content" android:id="@+id/itemcheck 3g" 
android:layout toRightOf="@id/itemcheck wifi"></CheckBox> 
<TextView android:layout height-"wrap content" android:id="@+id/app text" 
android:text="uid:packages" android:layout width="match parent" 
android:layout toRightOf="@id/itemcheck 3g" android:layout 
centerVertical-"true" 
android:paddingRight-"80sp"»«/TextView» 
<TextView android:layout height-"wrap content" android:id-"(-«id/download" 
android:layout width-"wrap content" android:layout 
alignParentRight-"true" 
android:layout centerVertical-"true" android:paddingLeft- 
"13sp"></TextView> 
<TextView android:layout height-"wrap content" android: id="@+id/upload" 
android: layout width-"wrap content" android:layout_toLeftof= 
"@id/download" 
android:layout centerVertical="true"></TextView> 
</RelativeLayout> 


系统 主 界面 的 效果 如 图 14-2 所 示 。 


图 14-2 主 界面 效果 
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14.4.2 ”帮助 界面 布局 文件 help_dialog.xml 


编写 帮助 界面 布局 文件 help_dialog xml， 主 要 代码 如 下 : 


«?xml version-"1.0" encoding-"utf-8"?» 
<FrameLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" android:layout height-"wrap content"» 
<ScrollView xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" android:layout height-"fill parent"> 
«TextView android:layout height-"fill parent" 
android:layout width-"fill parent" android:text- 
"@string/help dialog text" 
android:padding-"6dip" /> 
</ScrollView> 
</FrameLayout> 


系统 帮助 界面 的 效果 如 图 14-3 所 示 。 


P 
和 DroidWall v1.5.1b 


图 14-3 ”帮助 界面 效果 


14.5 编写 主 程序 文件 


布局 文件 编写 完毕 之 后 ， 还 需要 编写 值 文件 strings.xml， 具 体 代 码 比较 简单 ， 请 读者 
参考 本 书 附带 光盘 中 的 代码 即 可 ， 在 此 不 再 进行 详细 讲解 。 下 面 将 详细 讲解 用 Java 编写 主 
旦 序 文件 的 具体 过 程 。 


14.5.1 实现 服务 勾 选 处 理 和 模式 设置 功能 


首先 编写 文件 MainActivityjava， 此 文件 是 整个 系统 的 核心 ， 能 够 实现 服务 勾 选 处 理 
和 模式 设置 功能 ， 勾 选 后 会 禁止 或 开启 某 项 网 络 服务 。 文 件 MainActivityjava 的 具体 实现 
流程 如 下 。 
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(1) 定义 类 MainActivity 为 项 目 启动 后 首先 显示 的 Activity， 设 置 按 下 Menu 后 显示 的 
选项 ， 并 设置 需要 的 各 个 实例 函数 。 具 体 代 码 如 下 : 


/[** 
+ activity, 当 您 打开 应 用 时 ， 这 是 被 显示 的 屏幕 
eU 


public class MainActivity extends Activity implements 
OnCheckedChangeListener, 
OnClickListener ( 
// 3& F Menu 后 显示 的 选项 
private static final int MENU DISABLE = 0; 
private static final int MENU TOGGLELOG - 1; 
private static final int MENU APPLY = 2; 
private static final int MENU EXIT - 3; 
private static final int MENU HELP - 4; 
private static final int MENU SHOWLOG = 5; 
private static final int MENU SHOWRULES = 6; 
private static final int MENU CLEARLOG - 7; 
private static final int MENU SETPWD = 8; 


/** 进 展 对 话 实例 */ 
private ListView listview; 
GOverride 
public void onCreate(Bundle savedInstanceState) ( 
super.onCreate (savedInstanceState); 
checkPreferences(); 
setContentView (R.layout.main) ; 
this. findViewById(R.id.label mode) .setOnClickListener (this); 
Api.assertBinaries (this, true); 


@override 
protected void onStart() { 
super.onStart (); 
// Force re-loading the application list 
Log.d("DroidWall", "onStart() - Forcing APP list reload!"); 
Api.applications = null; 
} 
@override 
protected void onResume() { 
super .onResume () ; 
if (this.listview == null) { 
this.listview = (ListView) this.findViewById(R.id.listview) ; 


} 
refreshHeader(); 
final String pwd = getSharedPreferences (Api.PREFS NAME, 0) .getString( 
Api.PREF PASSWORD, ""); 
if (pwd.length() == O) ( 
// No password lock 
showOrLoadApplications(); 
) else { 
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// Check the password 
request Password (pwd) ; 


} 
@override 
protected void onPause() { 
super .onPause (); 
this.listview.setAdapter (null); 
} 


(2) 定义 函数 checkPreferences() 来 检查 被 存储 的 选项 是 否 正常 ， 具 体 代 码 如 下 : 
[** 
* 检查 被 存储 的 选项 是 否 正常 
private void checkPreferences() ( 
final SharedPreferences prefs = getSharedPreferences (Api.PREFS NAME, 0); 
final Editor editor - prefs.edit(); 
boolean changed - false; 
if (prefs.getString(Api.PREF MODE, "").length() == O) ( 
editor.putString(Api.PREF MODE, Api.MODE WHITELIST); 
changed - true; 


) 

/* 删除 旧 的 选项 名 字 */ 

if (prefs.contains("AllowedUids")) ( 
editor.remove ("AllowedUids"); 
changed - true; 

} 

if (prefs.contains("Interfaces")) { 
editor.remove ("Interfaces"); 
changed - true; 

) 

if (changed) 
editor.commit(); 

} 


(3) 定义 函数 refreshHeader0 来 刷新 显示 当前 运行 的 和 网 络 相关 的 程序 ， 共 体 代码 如 下 : 


/** 
* 刷新 显示 当前 运行 的 和 网 络 相关 的 程序 
E 


private void refreshHeader() ( 

final SharedPreferences prefs = getSharedPreferences (Api.PREFS NAME, 0); 

final String mode = prefs.getString(Api.PREF MODE, Api.MODE WHITELIST); 

final TextView labelmode - (TextView) this 
.findViewById(R.id.label mode); 

final Resources res - getResources(); 

int resid = (mode.equals(Api.MODE WHITELIST) ? R.string.mode whitelist 
: R.string.mode blacklist); 

labelmode.setText (res.getString(R.string.mode header, 
res.getString(resid))); 

resid = (Api.isEnabled(this) ? R.string.title enabled 
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: R.string.title disabled); 
setTitle(res.getString(resid, Api.VERSION)); 
} 


(4) 定义 函数 selectMode0 显 示 对 话 框 选择 操作 方式 ， 供 我 们 选择 黑 名 单 模式 还 是 白 名 
单 模式 。 具 体 代码 如 下 : 
[** 
* 显示 对 话 框 选择 操作 方式 ， 供 我 们 选择 黑 名 单 模式 还 是 白 名 单 模式 
iue 
private void selectMode() ( 
final Resources res - getResources(); 
new AlertDialog.Builder (this) 
-setItems ( 
new String[] { res.getString(R.string.mode whitelist), 
res.getString(R.string.mode blacklist) }, 
new DialogInterface.OnClickListener() { 
public void onClick(DialogInterface dialog, 
int which) { 
final String mode = (which == 0 ? Api.MODE WHITELIST 
: Api.MODE BLACKLIST) ; 
final Editor editor = getSharedPreferences ( 
Api.PREFS NAME, 0) .edit(); 
editor.putString(Api.PREF MODE, mode); 
editor.commit (); 
refreshHeader(); 
) 
)).setTitle("Select mode:").show(); 
) 


(5) 定义 函数 setPassword() 来 设置 一 个 系统 后， 在 进入 主 界面 前 
会 通过 函数 requestPassword0 来 验证 密码 ， 只 有 密码 正确 才能 进入 。 具 体 代 码 如 下 
/** 
* 设置 一 新 的 密码 
区 这 
private void setPassword(String pwd) ( 
final Resources res = getResources(); 
final Editor editor = getSharedPreferences (Api.PREFS NAME, 0).edit(); 
editor.putString(Api.PREF PASSWORD, pwd); 
String msg; 
if (editor.commit()) ( 
if (pwd.length() > 0) ( 
msg = res.getString(R.string.passdefined) ; 
) else ( 
msg = res.getString(R.string.passremoved) ; 


HB, bd 


H 
} eise ( 
msg = res.getString(R.string.passerror); 
$ 
Toast.makeText(MainActivity.this, msg, Toast.LENGTH SHORT).show(); 


> Andid sssannsmia 


/[** 
* 如 果 设置 了 密码 ， 显 示 主 界面 前 先 验证 密码 
af 


private void requestPassword(final String pwd) { 
new PassDialog(this, false, new android.os.Handler.Callback() { 
public boolean handleMessage (Message msg) { 

if (msg.obj == null) { 
MainActivity.this.finish(); 
android.os.Process.killProcess (android.os.Process.myPid()); 
return false; 

) 

if (!pwd.equals (msg.obj)) { 
request Password (pwd) ; 
return false; 


) 
// 如 果 密 码 正确 
showOrLoadApplications(); 
return false; 
) 
))-.show(); 
) 


(6) 编写 函数 toggleLogEnabled0) 来 实现 防火 墙 禁用 和 日 志 禁 用 开关 处 理 ， 有 具体 代码 
如 下 : 


/** 
* 开关 设置 
ey 
private void toggleLogEnabled() { 
final SharedPreferences prefs = getSharedPreferences (Api.PREFS NAME, 0); 
final boolean enabled - !prefs.getBoolean(Api.PREF LOGENABLED, false); 
final Editor editor - prefs.edit(); 
editor.putBoolean(Api.PREF LOGENABLED, enabled); 
editor.commit(); 
if (Api.isEnabled(this)) ( 
Api.applySavedIptablesRules (this, true); 
} 
Toast.makeText ( 
MainActivity.this, 
(enabled ? R.string.log was enabled : R.string.log was disabled), 
Toast.LENGTH SHORT).show(); 
} 


(7) 编写 函数 showOrLoadApplications0， 如 果 在 某 模式 下 有 应 用 则 显示 
函数 showOrLoadApplicationsO 的 具体 代码 如 下 : 


/[** 

* 如 果 某 模式 下 有 应 用 ， 则 显示 其 中 的 应 用 

e 

private void showOrLoadApplications() ( 
final Resources res - getResources(); 


T 


中 的 应 用 。 
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if (Api.applications == null) { 
final ProgressDialog progress = ProgressDialog.show(this, 
res.getString(R.string.working), 
res.getString(R.string.reading apps), true); 
final Handler handler - new Handler() ( 
public void handleMessage (Message msg) ( 
try 
progress.dismiss(); 
) catch (Exception ex) ( 
! 
showApplications(); 


new Thread() ( 
public void run() ( 
Api.getApps (MainActivity.this); 
handler.sendEmptyMessage (0) ; 
} 
).start(); 
) else ( 
// 储存 应 用 ， 显 示 名 单 


showApplications(); 


} 
(8) 编写 函数 showApplications() 显 示 应 用 名 单 ， 具 体 代码 如 下 : 


/** 
* 显示 应 用 名 单 
Sif 
private void showApplications() { 
final DroidApp[] apps = Api.getApps (this); 
// Sort applications - selected first, then alphabetically 
Arrays .sort (apps, new Comparator<DroidApp>() { 
@Override 
public int compare(DroidApp ol, DroidApp o2) { 
if ((ol.selected wifi | ol.selected 3g) == 
(02.selected wifi | o2.selected 3g)) ( 
return String.CASE INSENSITIVE ORDER.compare(ol.names[0], 
o2.names[0]); 
$ 
if (ol.selected wifi || ol.selected 3g) 
return -1; 
return 1; 


He 
final LayoutInflater inflater = getLayoutInflater(); 
final ListAdapter adapter = new ArrayAdapter<DroidApp> (this, 
R.layout.listitem, R.id.app text, apps) { 
@override 
public View getView(int position, View convertView, ViewGroup 
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parent) { 
ListEntry entry; 
if (convertView == null) { 
// Inflate a new view 
convertView = inflater.inflate(R.layout.listitem, parent, 
false); 
entry = new ListEntry(); 
entry.box wifi = (CheckBox) convertView 
.findViewById(R.id.itemcheck wifi); 
entry.box 3g = (CheckBox) convertView 
.-findViewById(R.id.itemcheck 3g); 
entry.app text - (TextView) convertView 
-findViewById(R.id.app text); 
entry.upload = (TextView) convertView 
-findViewById(R.id.upload); 
entry.download - (TextView) convertView 
. findViewById (R.id.download) ; 
convertView.setTag (entry); 
entry.box wifi 


. setOnCheckedChangeListener (MainActivity.this) ; 


entry.box 3g.setOnCheckedChangeListener (MainActivity.this) ; 

} else { 
// 转 换 一 个 现 有 视图 
entry = (ListEntry) convertView.getTag(); 

} 

final DroidApp app = apps[position]; 

entry.app text.setText (app.toString()); 

convertAndSetColor (TrafficStats.getUidTxBytes (app.uid), 
entry.upload) ; 

convertAndSetColor (TrafficStats.getUidRxBytes (app.uid), 
entry.download); 

final CheckBox box wifi - entry.box wifi; 

box wifi.setTag(app); 

box wifi.setChecked(app.selected wifi); 

final CheckBox box 3g - entry.box 3g; 

box 3g.setTag (app) 

box 3g.setChecked(app.selected 3g); 

return convertView; 

} 


(9) 编写 函数 convertAndSetColor()， 根 据 对 某 选 项 的 设置 显示 内 容 ， 并 设置 显示 内 容 
的 颜色 。 假 如 没有 任何 设置 ， 则 显示 “N/A”， 如 果 已 经 设置 了 启用 ， 则 显示 已 经 用 过 的 
流量 。 函 数 convertAndSetColor0 的 具体 代码 如 下 : 


private void convertAndSetColor(long num, TextView text) { 
String value - null; 
long temp = num; 
float floatnum — num; 
if (num = -1) { 
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value = "N/A "; 
text.setText (value); 
text.setTextColor (0xff919191); 
return ; 
) else if ((temp = temp / 1024) < 1) ( 
value = num + "B"; 
) else if ((floatnum - temp / 1024) « 1) ( 
value = temp + "KB"; 
f else { 
DecimalFormat format = new DecimalFormat ("440.0"); 
value = format.format(floatnum) + "MB"; 
) 
text.setText (value); 
text.setTextColor (0xffff0300); 


i 
this.listview.setAdapter (adapter); 
} 


(10) 进入 系统 主 界面 后 ， 如 果 按 下 Menu 键 则 会 弹出 设置 界面 ， 在 设置 界面 中 可 以 选 
择 对 应 的 功能 。 在 设置 界面 中 的 选择 功能 是 通过 以 下 三 个 函数 实现 的 。 


public boolean onCreateOptionsMenu (Menu menu) { 

menu.add(0, MENU DISABLE, 0, R.string.fw enabled).setIcon( 
android.R.drawable.button onoff indicator on); 

menu.add(0, MENU TOGGLELOG, 0, R.string.log enabled).setIcon( 
android.R.drawable.button onoff indicator on); 

menu.add(0, MENU APPLY, 0, R.string.applyrules).setIcon( 
R.drawable.apply); 

menu.add(0, MENU EXIT, 0, R.string.exit).setIcon( 
android.R.drawable.ic menu close clear cancel); 

menu.add(0, MENU HELP, 0, R.string.help).setIcon( 
android.R.drawable.ic menu help); 

menu.add(0, MENU SHOWLOG, 0, R.string.show log) 
-setIcon (R.drawable.show); 

menu.add(0, MENU SHOWRULES, 0, R.string.showrules).setIcon( 
R.drawable.show); 

menu.add(0, MENU CLEARLOG, 0, R.string.clear log).setIcon( 
android.R.drawable.ic menu close clear cancel); 

menu.add(0, MENU SETPWD, 0, R.string.setpwd).setlIcon( 
android.R.drawable.ic lock lock); 

return true; 


@override 

public boolean onPrepareOptionsMenu (Menu menu) { 
final MenuItem item onoff = menu.getItem(MENU DISABLE) ; 
final MenuItem item apply = menu.getItem(MENU APPLY) ; 
final boolean enabled = Api.isEnabled (this); 
if (enabled) { 
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item onoff.setIcon(android.R.drawable.button onoff indicator on); 
item onoff.setTitle(R.string.fw enabled); 
item apply.setTitle(R.string.applyrules); 
) else ( 
item onoff.setIcon (android.R.drawable.button onoff indicator off); 
item onoff.setTitle(R.string.fw disabled); 
item apply.setTitle(R.string.saverules); 


} 

final MenuItem item log = menu.getItem(MENU TOGGLELOG) ; 

final boolean logenabled = getSharedPreferences (Api.PREFS NAME, 0) 

.getBoolean (Api .PREF LOGENABLED, false); 

if (logenabled) { 
item log.setIcon(android.R.drawable.button onoff indicator on); 
item log.setTitle(R.string.log enabled); 

) else ( 
item log.setIcon(android.R.drawable.button onoff indicator off); 
item log.setTitle(R.string.log disabled); 

) 

return super.onPrepareOptionsMenu (menu); 


GOverride 
public boolean onMenuItemSelected(int featureId, MenuItem item) ( 

switch (item.getItemId()) { 

case MENU DISABLE: 
disableOrEnable() ; 
return true; 

case MENU TOGGLELOG: 
toggleLogEnabled(); 
return true; 

case MENU APPLY: 
applyOrSaveRules(); 
return true; 

case MENU EXIT: 
finish():; 
System.exit (0); 
return true; 

case MENU HELP: 
new HelpDialog(this).show(); 
return true; 

case MENU SETPWD: 
setPassword(); 
return true; 

case MENU SHOWLOG: 
showLog(); 
return true; 

case MENU SHOWRULES: 
showRules (); 
return true; 

case MENU CLEARLOG: 
clearLog(); 
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return true; 
} 
return false; 


} 
(11) 编写 函数 disableOrEnable0O) 设 置 开启 或 关闭 防火 墙 ， 具体 代 码 如 下 : 


private void disableOrEnable() { 
final boolean enabled = !Api.isEnabled (this); 
Log.d("DroidWall", "Changing enabled status to: " + enabled); 
Api.setEnabled(this, enabled); 
if (enabled) ( 
applyOrSaveRules(); 
) else ( 
purgeRules(); 
) 
refreshHeader(); 
) 


(12) 编写 函数 setPassword( 来 到 设置 密码 界面 ， 有 具体 代码 如 下 : 


private void setPassword() ( 
new PassDialog(this, true, new android.os.Handler.Callback() ( 
public boolean handleMessage (Message msg) ( 
if (msg.obj !- null) ( 
setPassword((String) msg.obj); 
} 
return false; 
} 
)).show(); 
) 


(13) 选择 Save rules( 保 存 规则 ) 后 执行 函数 showRules0， 有 具体 代码 如 下 : 


private void showRules() ( 
final Resources res - getResources(); 
final ProgressDialog progress - ProgressDialog.show (this, 
res.getString(R.string.working), 
res.getString(R.string.please wait), true); 
final Handler handler - new Handler() ( 
public void handleMessage (Message msg) ( 
try ( 
progress.dismiss(); 
) catch (Exception ex) ( 
} 
if (!Api.hasRootAccess (MainActivity.this, true)) 
return; 
Api.showIptablesRules (MainActivity.this); 


he 
handler.sendEmptyMessageDelayed(0, 100); 
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(14) 编写 函数 showLogO 显 示 日 志 信息 界面 ， 具 体 代 码 如 下 : 


private void showLog() { 
final Resources res = getResources(); 


final ProgressDialog progress = ProgressDialog.show (this, 
res.getString(R.string.working), 
res.getString(R.string.please wait), true); 

final Handler handler - new Handler() ( 

public void handleMessage (Message msg) ( 
try { 
progress.dismiss(); 

) catch (Exception ex) ( 
} 
Api.showLog (MainActivity.this) ; 


MF 
handler.sendEmptyMessageDelayed(0, 100); 
} 


(15) 编写 函数 clearLog0 清 除 系统 内 的 日 志 记 录 信 息 ， 具 体 代码 如 下 : 


private void clearLog() { 
final Resources res = getResources(); 
final ProgressDialog progress - ProgressDialog.show(this, 
res.getString(R.string.working), 
res.getString(R.string.please wait), true); 
final Handler handler = new Handler() { 
public void handleMessage (Message msg) ( 
try ( 
progress.dismiss(); 
) catch (Exception ex) ( 
} 
if (!Api.hasRootAccess (MainActivity.this, true)) 
return; 
if (Api.clearLog(MainActivity.this)) ( 
Toast.makeText (MainActivity.this, R.string.log cleared, 
Toast.LENGTH SHORT).show(); 


Nn 
handler.sendEmptyMessageDelayed(0, 100); 
H 


(16) 编写 函数 applyOrSaveRules0， 当 申请 或 保存 规则 后 将 规则 运用 到 本 系统 。 有 具体 
代码 如 下 : 


private void applyOrSaveRules() { 
final Resources res = getResources(); 
final boolean enabled - Api.isEnabled (this); 
final ProgressDialog progress - ProgressDialog.show(this, res 
.getString(R.string.working), res 
-getString(enabled ? R.string.applying rules 
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: R.string.saving rules), true); 
final Handler handler - new Handler() ( 
public void handleMessage (Message msg) ( 
try ( 
progress.dismiss(); 
) catch (Exception ex) { 
b 
if (enabled) ( 
Log.d("DroidWall", "Applying rules."); 
if (Api.hasRootAccess (MainActivity.this, true) 
&& Api.applyIptablesRules (MainActivity.this, true)) ( 
Toast.makeText (MainActivity.this, 
R.string.rules applied, Toast.LENGTH SHORT) 
-show(); 
) else ( 
Log.d("DroidWall", "Failed - Disabling firewall."); 
Api.setEnabled(MainActivity.this, false); 
} 
y sise 4 
Log.d("DroidWall", "Saving rules."); 
Api.saveRules (MainActivity.this); 
Toast.makeText (MainActivity.this, R.string.rules saved, 
Toast.LENGTH SHORT).show(); 


}; 
handler.sendEmptyMessageDelayed(0, 100); 
) 


(17) 编写 函数 purgeRules0) 来 清除 一 个 规则 ， 有 具体 代码 如 下 : 


private void purgeRules() ( 
final Resources res - getResources(); 
final ProgressDialog progress - ProgressDialog.show (this, 
res.getString(R.string.working), 
res.getString(R.string.deleting rules), true); 
final Handler handler - new Handler() ( 
public void handleMessage (Message msg) ( 
try ( 
progress.dismiss(); 
) catch (Exception ex) ( 
} 
if (!Api.hasRootAccess (MainActivity.this, true) ) 
return; 
if (Api.purgeIptables(MainActivity.this, true)) { 
Toast .makeText (MainActivity.this, R.string.rules deleted, 
Toast.LENGTH SHORT) .show(); 


i 
handler.sendEmptyMessageDelayed(0, 100); 
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(18) 编写 函数 onCheckedChanged()E? fr Wi-Fi 选项 和 3G 选项 是 否 发 生变 化 。 有 具体 代 
人 码 如 下 : 


public void onCheckedChanged (CompoundButton buttonView, boolean isChecked) { 
final DroidApp app = (DroidApp) buttonView.getTag(); 
if (app != null) ( 
switch (buttonView.getId()) ( 
case R.id.itemcheck wifi: 
app.selected wifi = isChecked; 
break; 
case R.id.itemcheck 3g: 
app.selected 3g - isChecked; 
break; 


) 
到 此 为 止 ， 主 界面 程序 介绍 完毕 ， 按 下 Menu 键 后 会 弹出 设置 界面 ， 如 图 14-4 所 示 。 


图 14-4 设置 界面 效果 


14.5.2 ”实现 帮助 模块 


编写 文件 HelpDialogjava 。 单 击 设置 界面 中 的 辆 按钮 将 会 弹出 帮助 界面 。 文 件 
HelpDialog java 的 具体 代码 如 下 : 


import android.app.AlertDialog; 

import android.content.Context; 

import android.view.View; 

public class HelpDialog extends AlertDialog ( 

protected HelpDialog(Context context) ( 
super (context); 
final View view = getLayoutInflater().inflate(R.layout. 
help dialog, null); 

setButton(context.getText(R.string.close), (OnClickListener)null); 
setIcon(R.drawable.icon); 
setTitle("DroidWall v" + Api.VERSION); 
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setView (view); 


14.5.8 ”实现 公共 库 函 数 


编写 文件 Apijava， 在 此 文件 中 定义 项 目 中 需要 的 公共 库 函 数 。 为 了 便于 项 目的 开 
发 ， 专 门 用 此 文件 保存 了 系统 中 经 常 需要 的 函数 。 文 件 Apijava 的 具体 实现 流程 如 下 。 

(1) 编写 函数 scriptHeaderO 创 建 一 个 通用 的 Script 程序 头 ， 此 程序 可 供 二 进 制 数据 使 
用 。 有 具体 代码 如 下 : 


private static String scriptHeader(Context ctx) ( 
final String dir = ctx.getDir("bin", 0).getAbsolutePath(); 
final String myiptables = dir + "/iptables armv5"; 
return "" + "IPTABLES=iptables\n" + "BUSYBOX=busybox\n" + "GREP=grep\n" 
"ECHO=echo\n" + "# Try to find busybox\n" + "if " 
dir 
"/busybox gl --help >/dev/null 2>/dev/null ; then\n" 
" BUSYBOX-" 
dir 
"/pusybox gl\n" 
" GREP-V"SBUSYBOX grep\"\n" 
" ECHO=\"$BUSYBOX echo\"\n" 
"elif busybox --help >/dev/null 2>/dev/null ; then\n" 
" BUSYBOX=busybox\n" 
"elif /system/xbin/busybox --help >/dev/null 
2>/dev/null ; then\n" 
" BUSYBOX=/system/xbin/busybox\n" 
"elif /system/bin/busybox --help >/dev/null 
2>/dev/null ; then\n" 
" BUSYBOX=/system/bin/busybox\n" 
Nan 
"# Try to find grep\n" 
"if ! SECHO 1 | $GREP -q 1 »/dev/null 2>/dev/null ; then\n" 
" if $ECHO 1 | $BUSYBOX grep -q 1 >/dev/null 
2»/dev/null ; thenin" 


*okoktokokokokokokoRko 


+ + 


++ + + + 


ee tad GREP=\"$BUSYBOX grep\"\n" 

+ " fi\n" 

+ " # Grep is absolutely required\n" 

+ " if ! SECHO 1 | $GREP -q 1 »/dev/null 2>/dev/null ; then\n" 

+" SECHO The grep command is required. DroidWall 
will not work. An" 

Sod exit 1\n" 

+ UEIN" 

ND 

+ "# Try to find iptables\n" 

Sr 2) 

+ myiptables 

+ " —version >/dev/null 2>/dev/null ; then\n" 
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+ " IPTABLES-" 
+ myiptables + "\n" + "fi\n" + ""; 


} 


(2) 编写 函数 copyRawFile0， 复 制 一 个 未 加 工 的 资源 文件 ， 根 据 其 ID 给 特定 地 点 。 
具体 代码 如 下 : 


private static void copyRawFile(Context ctx, int resid, File file, 
String mode) throws IOException, InterruptedException ( 
final String abspath - file.getAbsolutePath(); 
// 在 Iptables 写 入 二 进 制 数据 
final FileOutputStream out = new FileOutputStream(file); 


final InputStream is = ctx.getResources() .openRawResource (resid); 
byte buf[] = new byte[1024]; 
int len; 


while ((len = is.read(buf)) > 0) { 
out .write (buf, 0, len); 

) 

out.close(); 

is.close(); 

// 允许 改变 

Runtime.getRuntime () .exec ("chmod " + mode + " " + abspath).waitFor(); 
} 


(3) 编写 函数 applyIptablesRulesImpl0， 功 能 是 清洗 并 且 重 新 加 写 所 有 规则 ， 此 功能 是 
在 内 部 实施 的 。 函 数 applyIptablesRulesImpl0 的 具体 代码 如 下 : 


private static boolean applyIptablesRulesImpl(Context ctx, 
List«Integer» uidsWifi, List«Integer» uids3g, boolean showErrors) ( 
if (ctx == null) ( 
return false; 
} 
assertBinaries (ctx, showErrors) ; 
final String ITFS WIFI[] = { "tiwlan+", "wlan+", "eth+" }; 
final String ITFS 3G[] = ( "rmnet+", "pdp+", "ppp+", "uwbr+", "wimax+", 
"vsnet+" }; 
final SharedPreferences prefs = ctx.getSharedPreferences (PREFS NAME, 0); 
final boolean whitelist = prefs.getString(PREF MODE, MODE WHITELIST) 
-equals (MODE WHITELIST); 
final boolean blacklist = !whitelist; 
final boolean logenabled = ctx.getSharedPreferences (PREFS NAME, 0) 
-getBoolean (PREF LOGENABLED, false); 
final StringBuilder script = new StringBuilder (); 
try { 
int code; 
script .append (scriptHeader (ctx) ) 
script.append("" 
+ "SIPTABLES --version || exit 1\n" 
+ "# Create the droidwall chains if necessary\n" 
+ "SIPTABLES -L droidwall >/dev/null 2»/dev/null || 
SIPTABLES --new droidwall || exit 2\n" 
+ "SIPTABLES -L droidwall-3g >/dev/null 2>/dev/null 
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11 $IPTABLES --new droidwall-3g || exit 3\n" 
+ "SIPTABLES -L droidwall-wifi »/dev/null 2»/dev/null 


|| SIPTABLES --new droidwall-wifi || exit 4\n" 
+ "SIPTABLES -L droidwall-reject »/dev/null 2>/dev/null 
|| SIPTABLES --new droidwall-reject || exit 5\n" 


+ "# Add droidwall chain to OUTPUT chain if necessary\n" 
+ "SIPTABLES -L OUTPUT | SGREP -q droidwall 
|| $IPTABLES -A OUTPUT -j droidwall || exit 6n" 
"# Flush existing rules\n" 
"SIPTABLES -F droidwall || exit 7\n" 
"SIPTABLES -F droidwall-3g || exit 8\n" 
"SIPTABLES -F droidwall-wifi || exit 9\n" 
+ "SIPTABLES -F droidwall-reject || exit 10\n" + ""); 
// 检查 是 否 能 设置 
if (logenabled) { 
Script.append("" 
+ "# Create the log and reject rules (ignore 
errors on the LOG target just in case it is 
not available) \n" 
+ "SIPTABLES -A droidwall-reject -j LOG --log- 
prefix \"[DROIDWALL] V" --log-uid\n" 
- "SIPTABLES -A droidwall-reject -j REJECT 
I| exit 11\n" 
cy 


+ + tt 


) else ( 
script.append("" 
+ "# Create the reject rule (log disabled) Wn" 
+ "SIPTABLES -A droidwall-reject -j REJECT 
I| exit 11 Xn" 
ne S7 
} 
if (whitelist && logenabled) { 
script.append("# Allow DNS lookups on white-list for a 
better logging (ignore errors) Mn"); 
script.append("$IPTABLES -A droidwall -p udp --dport 53 
-j RETURN Tn"); 
) 
script.append("# Main rules (per interface) Wn"); 
for (final String itf : ITFS 3G) ( 
script.append("$IPTABLES -A droidwall -o ").append(itf) 
.append(" -j droidwall-3g || exitin"); 
} 
for (final String itf : ITFS WIFI) { 
script.append("S$IPTABLES -A droidwall -o ") .append(itf) 
.append(" -j droidwall-wifi || exit\n"); 
} 
script.append("# Filtering rules\n"); 
final String targetRule = (whitelist ? "RETURN" 
: "droidwall-reject"); 
final boolean any 3g = uids3g.indexOf (SPECIAL UID ANY) >= 0; 
final boolean any wifi = uidsWifi.indexOf (SPECIAL UID ANY) >= 0; 
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if (whitelist && !any wifi) { 
// 当 设置 开启 WI-FI 时 需要 保证 用 户 允 许 DHCP 和 WI-FI 功能 
int uid = android.os.Process.getUidForName ("dhcp"); 
if (uid != -1) ( 
script.append("# dhcp userWn"); 
script.append( 
"SIPTABLES -A droidwall-wifi -m owner --uid-owner ") 
-append(uid).append(" -j RETURN || exit\n"); 


} 
uid = android.os.Process.getUidForName ("wifi"); 
if (uid 1= -1) ( 
script.append("# wifi user\n"); 
script.append ( 


"SIPTABLES -A droidwall-wifi -m owner --uid-owner ") 
.append(uid).append(" -j RETURN || exit Win"); 
) 
) 
if (any 3g) ( 
if (blacklist) ( 
/* block any application on this interface */ 
script.append("$IPTABLES -A droidwall-3g -j ") 
.append(targetRule).append(" || exit\n"); 
) 
) else ( 
/* 释 放 或 阻塞 在 这 个 接口 的 各 自 的 应 用 */ 
for (final Integer uid : uids3g) ( 
if (uid »- 0) 
script.append( 
"SIPTABLES -A droidwall-3g -m owner --uid-owner ") 
.append(uid).append(" -j ") .append(targetRule) 
.append(" || exitin"); 


) 
if (any wifi) ( 
if (blacklist) ( 


/* 阻 塞 在 这 个 接口 的 所 有 应 用 */ 
script.append("S$IPTABLES -A droidwall-wifi -j ") 
.append(targetRule).append(" || exit\n"); 
} 
} else { 


/* 释 放 或 阻塞 在 这 个 接口 的 各 自 的 应 用 */ 
for (final Integer uid : uidsWifi) ( 
if (uid >= 0) 
script .append ( 
"SIPTABLES -A droidwall-wifi -m owner --uid-owner ") 
-append(uid).append(" -j ").append(targetRule) 
-append(" || exit in"); 


} 
if (whitelist) { 
if (‘any 3g) { 
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if (uids3g.indexOf (SPECIAL UID KERNEL) >= 0) ( 
script.append("# hack to allow kernel packets on 
white-list\n"); 
script.append("$IPTABLES -A droidwall-3g -m owner 
--uid-owner 0:999999999 -j droidwall-reject 
|| exit\n"); 
} else { 
Script.append("SIPTABLES -A droidwall-3g -j 
droidwall-reject || exit Wn"); 


) 
if (!any wifi) ( 
if (uidsWifi.indexOf (SPECIAL UID KERNEL) »- 0) ( 
script.append("# hack to allow kernel packets on 
white-list\n"); 
script.append("$IPTABLES -A droidwall-wifi -m 
owner --uid-owner 0:999999999 -j droidwall- 


reject || exit\n"); 
) else ( 
script.append("$IPTABLES -A droidwall-wifi -j 
droidwall-reject || exit\n"); 


} 
} else { 
if (uids3g.indexOf (SPECIAL UID KERNEL) >= 0) { 
script.append("# hack to BLOCK kernel packets on 
black-list\n"); 
script.append("$IPTABLES -A droidwall-3g -m owner -- 
uid-owner 0:999999999 -j RETURN || exit in"); 
script.append("$IPTABLES -A droidwall-3g -j 
droidwall-reject || exit\n"); 
} 
if (uidsWifi.indexOf (SPECIAL UID KERNEL) >= 0) { 
script.append("# hack to BLOCK kernel packets on 
black-list\n"); 
script.append("$IPTABLES -A droidwall-wifi -m owner - 
-uid-owner 0:999999999 -j RETURN || exit Win"); 
Script.append("SIPTABLES -A droidwall-wifi -j 
droidwall-reject || exit\n"); 


} 
final StringBuilder res = new StringBuilder(); 
code = runScriptAsRoot(ctx, script.toString(), res); 
if (showErrors && code != 0) { 
String msg - res.toString(); 
Log.e("DroidWall", msg); 
// 去 除 多 余 的 帮助 信息 
if (msg.indexOf("\nTry 'iptables -h' or 'iptables --help' 
for more information.") != -1) { 
msg = msg 
-replace( 
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"\nTry ‘iptables -h' or ‘iptables --help' for 


more information.", 
Wee 
} 
alert (ctx, "Error applying iptables rules. Exit code: " + code 
+ "\n\n" + msg.trim()); 
} else { 
return true; 
} 
} catch (Exception e) { 
if (showErrors) 
alert (ctx, "error refreshing iptables: " + e); 


} 
return false; 
} 
(4) 编写 函数 applySavedIptablesRules0， 功 能 是 清洗 并 且 重 新 加 写 所 有 规则 ， 此 规则 
不 是 内 存 中 保存 的 。 因 为 不 需要 读 安装 引用 程序 ， 所 以 此 方法 比 函 数 
applyIptablesRulesImpl(0 方 式 快 。 函 数 applySavedIptablesRulesO 的 具体 代码 如 下 : 


public static boolean applySavedIptablesRules (Context ctx, 
boolean showErrors) ( 
if (ctx == null) ( 
return false; 


) 
final SharedPreferences prefs = ctx.getSharedPreferences (PREFS NAME, 0); 
final String savedUids wifi = prefs.getString(PREF WIFI UIDS, ""); 
final String savedUids 3g - prefs.getString(PREF 3G UIDS, ""); 
final List«Integer» uids wifi = new LinkedList<Integer>(); 
if (savedUids wifi.length() » O) ( 
// 检查 哪 一 些 应 用 使 用 Wi-Fi 
final StringTokenizer tok = new StringTokenizer(savedUids wifi, "|"); 
while (tok.hasMoreTokens()) { 
final String uid - tok.nextToken(); 
if (!uid.equals("")) ( 


Ery f 
uids wifi.add(Integer.parseInt (uid)); 


) catch (Exception ex) ( 
) 


} 
final List<Integer> uids 3g = new LinkedList<Integer>(); 


if (savedUids 3g.length() > 0) { 
// 检 查 哪 些 应 用 允许 26/36 服务 


final StringTokenizer tok = new StringTokenizer (savedUids 3g, "|"); 
while (tok.hasMoreTokens()) { 

final String uid - tok.nextToken(); 

if (!uid.equals("")) ( 


try ( 
uids 3g.add(Integer.parseInt (uid)); 
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} catch (Exception ex) { 


} 
} 
return applyIptablesRulesImpl (ctx, uids wifi, uids 3g, showErrors); 
} 


(5) 编写 函数 saveRules0， 根 据 设 置 的 选择 项 保存 当前 的 规则 ， 有 具体 代码 如 下 : 


public static void saveRules (Context ctx) { 
final SharedPreferences prefs = ctx.getSharedPreferences (PREFS NAME, 0); 
final DroidApp[] apps = getApps (ctx); 
// 建立 被 隔离 的 名 单列 表 
final StringBuilder newuids wifi = new StringBuilder(); 
final StringBuilder newuids 3g - new StringBuilder(); 
for (int i = 0; i « apps.length; i++) ( 
if (apps[i].selected wifi) { 
if (newuids wifi.length() != 0) 
newuids wifi.append('|'); 
newuids wifi.append(apps[i].uid); 
) 
if (apps[i].selected 3g) ( 
if (newuids 3g.length() !- 0) 
newuids 3g.append('|'); 
newuids 3g.append (apps [i] .uid) ; 
} 
) 
// 除 UIDs 新 的 名 单 之 外 
final Editor edit = prefs.edit(); 
edit.putString(PREF WIFI UIDS, newuids wifi.toString()); 
edit.putString(PREF 3G UIDS, newuids 3g.toString()); 
edit.commit (); 
} 


(6) 编写 函数 purgeIptables0) 清 除 所 有 的 过 滤 规 则 ， 有 具体 代码 如 下 : 


public static boolean purgeIptables(Context ctx, boolean showErrors) { 
StringBuilder res = new StringBuilder(); 
try ( 
assertBinaries(ctx, showErrors); 
int code - runScriptAsRoot(ctx, scriptHeader (ctx) 
+ "$IPTABLES -F droidwall\n" 
+ "$IPTABLES -F droidwall-reject\n" 
+ "$IPTABLES -F droidwall-3g\n" 
+ "$IPTABLES -F droidwall-wifi\n", res); 
if (code == -1) { 
if (showErrors) 
alert (ctx, "error purging iptables. exit code: " + code 
+ "\n" + res); 
return false; 
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return true; 
) catch (Exception e) ( 
if (showErrors) 
alert(ctx, "error purging iptables: " + e); 
return false; 


) 
(7) 编写 函数 clearLog(O) 清 除 系统 中 的 日 志 记录 信息 ， 具 体 代 码 如 下 : 


public static boolean clearLog(Context ctx) ( 


try i 
final StringBuilder res = new StringBuilder (); 
int code = runScriptAsRoot (ctx, "dmesg -c »/dev/null || exit\n", 


res); 
if (code != 0) { 
alert (ctx, res); 
return false; 


} 

return true; 
} catch (Exception e) { 

alert (ctx, "error: " + e); 
} 
return false; 


} 
(8) 编写 函数 showLogO 显 示 系 统 中 的 日 志 记录 信息 ， 有 具体 代码 如 下 : 


public static void showLog(Context ctx) ( 
try ( 
StringBuilder res = new StringBuilder(); 
int code = runScriptAsRoot(ctx, scriptHeader (ctx) 
+ "dmesg | $GREP DROIDWALL\n", res); 
if (code != 0) ( 
if (res.length() == 0) ( 
res.append("Log is empty"); 
} 
alert(ctx, res); 
return; 
} 
final BufferedReader r = new BufferedReader (new StringReader ( 
res.toString())); 
final Integer unknownUID - -99; 
res = new StringBuilder(); 
String line; 
int start, end; 
Integer appid; 
final HashMap<Integer, LogInfo» map = new HashMap<Integer, LogInfo>(); 
LogInfo loginfo = null; 
while ((line = r.readLine()) != null) { 
if (line.indexOf ("[DROIDWALL]") == -1) 
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continue; 
appid = unknownUID; 
if (Cistart = Minesinderzon( rn 1= =I} 
&& ((end = line.indexOf(" ", start)) != -1)) ( 


appid = Integer.parseInt(line.substring(start + 4, end)); 
} 
loginfo = map.get (appid) ; 
if (loginfo == null) { 
loginfo = new LogInfo(); 
map.put(appid, loginfo) ; 
} 
loginfo.totalBlocked += 1; 
if (((start = line.indexOf("DST-")) !- -1) 
&& ((end = line.indexOf(" ", start)) !- -1)) ( 
String dst = line.substring(start + 4, end); 
if (loginfo.dstBlocked.containsKey(dst)) { 
loginfo.dstBlocked.put (dst, 
loginfo.dstBlocked.get (dst) + 1); 
} else { 
loginfo.dstBlocked.put (dst, 1); 


} 
final DroidApp[] apps = getApps (ctx); 
for (Integer id : map.keySet()) { 
res.append("App ID "); 
if (id != unknownUID) { 
res.append (id) ; 
for (DroidApp app : apps) { 
if (app.uid == id) { 
res.append(" (").append(app.names[0]); 
if (app.names.length » 1) ( 
res.append(", ...)"); 
) else ( 
res.append(")"); 
} 
break; 


H 
) else ( 
res.append(" (kernel)"); 
$ 
loginfo = map.get (id); 
res.append(" - Blocked ").append(loginfo.totalBlocked) 
-append(" packets"); 
if (loginfo.dstBlocked.size() > 0) { 
res.append(" ("); 
boolean first = true; 
for (String dst : loginfo.dstBlocked.keySet()) { 
if (first)y { 
res.append(", "); 
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) 

res.append (loginfo.dstBlocked.get (dst)) 
-append(" packets for ").append (dst); 

first - false; 


} 
res.append(")"); 
} 
res.append("\n\n"); 
} 
if (res.length() == 0) { 
res.append("Log is empty"); 
) 


alert(ctx, res); 
) catch (Exception e) ( 
alert(ctx, "error: " + e); 


} 
(9) 编写 函数 hasRootAccess() 检 查 是 否 具备 进入 根 目录 的 权限 ， 上 具体 代 码 如 下 : 


public static boolean hasRootRccess (Context ctx, boolean showErrors) ( 
if (hasroot) 
return true; 
final StringBuilder res - new StringBuilder(); 


try ( 
// Run an empty script just to check root access 
if (runScriptAsRoot(ctx, "exit 0", res) == 0) ( 


hasroot - true; 
return true; 
) 
) catch (Exception e) ( 
) 
if (showErrors) ( 
alert(ctx, 
"Could not acquire root access.\n" 
+ "You need a rooted phone to run DroidWall.\n\n" 
+ "If this phone is already rooted, please 
make sure DroidWall has enough 
permissions to execute the \"su\" 
command. \n" 
+ "Error message: " + res.toString()); 
} 
return false; 
} 


(10) 编写 函数 ranScript0 执 行 前 面 编写 的 Script 脚本 头 程序 ， 此 函数 比较 具有 代表 意 
义 ， 能 够 在 Android 中 调用 并 执行 Script 程序 。 函 数 mnScript0 的 具体 代码 如 下 : 
public static int runScript(Context ctx, String script, StringBuilder res, 
long timeout, boolean asroot) ( 


final File file = new File(ctx.getDir("bin", 0), SCRIPT FILE); 
final ScriptRunner runner = new ScriptRunner(file, script, res, asroot); 
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runner.start(); 
try ( 
if (timeout > 0) { 
runner. join (timeout) ; 
} else { 
runner.join(); 


} 

if (runner.isAlive()) { 
// 设置 超时 
runner.interrupt(); 
runner.join(130); 
runner.destroy(); 
runner.join(50); 

) 

) catch (InterruptedException ex) ( 


} 
return runner.exitcode; 


} 
(11) 编写 函数 runScriptAsRoot0， 功 能 是 在 Root 权限 下 执行 脚本 程序 。 具 体 代码 如 下 : 


public static int runScriptAsRoot (Context ctx, String script, 
StringBuilder res, long timeout) { 
return runScript(ctx, script, res, timeout, true); 
) 


(12) 编写 函数 mnScript()， 功 能 是 设置 普通 用 户 权限 执行 脚本 程序 。 具 体 代码 如 下 : 


public static int runScript(Context ctx, String script, StringBuilder res) 
throws IOException ( 
return runScript(ctx, script, res, 40000, false); 
) 
(13) 编写 函数 assertBinaries()， 功 能 是 判断 二 进 制 文件 在 高 
代码 如 下 : 
public static boolean assertBinaries (Context ctx, boolean showErrors) { 
boolean changed = false; 
try { 
// 检查 iptables armv5 过 滤 包 
File file = new File(ctx.getDir("bin", 0), "iptables armv5"); 
if (!file.exists()) { 
copyRawFile(ctx, R.raw.iptables armv5, file, "755"); 
changed - true; 


速 缓存 目录 被 安装 。 有 具体 


H 
// 检 查 busybox 
file = new File(ctx.getDir("bin", 0), "busybox gl"); 
if (!file.exists()) { 
copyRawFile(ctx, R.raw.busybox gl, file, "755"); 
changed - true; 
} 
if (changed) { 
Toast.makeText(ctx, R.string.toast bin installed, 
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Toast.LENGTH LONG).show(); 


) 
) catch (Exception e) ( 
if (showErrors) 
alert(ctx, "Error installing binary files: " + e); 
return false; 
) 
return true; 


1454 ”实现 广播 模块 


编写 文件 BootBroadcastjava， 此 文件 是 一 个 广播 文件 ， 在 系统 执行 后 将 广播 ptables 
规则 。 因 为 在 规则 中 并 没有 设置 开启 显示 信息 ， 所 以 使 用 广播 功能 显示 设置 信息 。 文 件 
BootBroadcastjava 的 主要 代码 如 下 : 


import android.content.BroadcastReceiver; 

import android.content.Context; 

import android.content.Intent; 

import android.os.Handler; 

import android.os.Message; 

import android.widget.Toast; 

public class BootBroadcast extends BroadcastReceiver ( 


public void onReceive(final Context context, final Intent intent) ( 
if (Intent.ACTION BOOT COMPLETED.equals (intent.getAction())) { 
if (Api.isEnabled(context)) ( 
final Handler toaster - new Handler() ( 

public void handleMessage (Message msg) ( 
if (msg.argl !- 0) 

Toast.makeText (context, msg.argl, 

Toast.LENGTH SHORT).show(); 
H 


n 
// 开启 新 线程 阻止 防火 墙 
new Thread() { 
@override 
public void run() { 
if (!Api.applySavedIptablesRules (context, false)) { 
// Error enabling firewall on boot 
final Message msg - new Message(); 
msg.argl = R.string.toast error enabling; 
toaster.sendMessage (msg) ; 
Api.setEnabled(context, false); 


i 
)-.start(); 


OB€ 142€ 流量 监控 系统 


14.5.5 ”删除 针对 软件 的 设置 规则 


编写 文件 PackageBroadcast.java， 此 文件 也 是 一 个 具备 广播 功能 的 文件 。 当 在 手机 
卸载 一 个 软件 后 ， 会 在 防火 墙 中 删除 针对 此 软件 的 设置 规则 。 文 件 PackageBroadcastjava 
的 主要 代码 如 下 : 

import android.content.BroadcastReceiver; 


import android.content.Context; 
import android.content.Intent; 


uü 


public class PackageBroadcast extends BroadcastReceiver ( 


GOverride 
public void onReceive(Context context, Intent intent) ( 
if (Intent.ACTION PACKAGE REMOVED.equals (intent.getAction())) ( 
// 忽 略 应 用 更 新 
final boolean replacing = intent.getBooleanExtra 
(Intent.EXTRA REPLACING, false); 
if (!replacing) ( 
final int uid = intent.getIntExtra (Intent.EXTRA UID, -123); 
Api.applicationRemoved (context, uid); 


14.5.0 ”登录 验证 


编写 文件 PassDialog.java， 功 能 是 在 输入 密码 对 话 框 中 获取 用 户 输入 的 密码 ， 只 有 输 
入 合法 的 密码 才能 登录 系统 。 文 件 PassDialog.java 的 主要 代码 如 下 : 


public class PassDialog extends Dialog implements 
android.view.View.OnClickListener, android.view.View.OnKeyListener, 
OnCancelListener ( 
private final Callback callback; 
private final EditText pass; 
/** 创 建 一 个 对 话 框 */ 
public PassDialog (Context context, boolean setting, Callback callback) { 
super (context); 
final View view = getLayoutInflater().inflate(R.layout.pass dialog, null); 
((TextView)view.findViewById(R.id.pass message)).setText 
(setting ? R.string.enternewpass : R.string.enterpass); 
((Button)view.findViewById(R.id.pass ok)) .setOnClickListener (this); 
((Button)view.findViewById(R.id.pass cancel) ) .setOnClickListener (this); 
this.callback = callback; 
this.pass = (EditText) view.findViewById(R.id.pass input); 
this.pass.setOnKeyListener (this); 
setTitle(setting ? R.string.pass titleset : R.string.pass titleget); 
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setonCancelListener (this); 
setContentView (view); 
} 
@override 
public void onClick(View v) { 
final Message msg = new Message(); 
if (v.getId() == R.id.pass ok) { 
msg.obj = this.pass.getText().toString(); 
} 
dismiss (); 
this.callback.handleMessage (msg) ; 
} 
GOverride 
public boolean onKey(View v, int keyCode, KeyEvent event) ( 
if (keyCode == KeyEvent.KEYCODE ENTER) ( 
final Message msg - new Message(); 
msg.obj = this.pass.getText().toString(); 
this.callback.handleMessage (msg); 
dismiss (); 
return true; 
} 
return false; 
} 
GOverride 
public void onCancel(DialogInterface dialog) ( 
this.callback.handleMessage (new Message()); 


14.5.7 ”打开 或 关闭 某 一 个 实施 控件 
编写 文件 StatusWidgetjava， 功 能 是 打开 或 关闭 某 一 个 实施 控件 。 主 要 代码 如 下 : 


public class StatusWidget extends AppWidgetProvider { 
GOverride 
public void onReceive(final Context context, final Intent intent) { 
super.onReceive(context, intent); 
if (Api.STATUS CHANGED MSG.equals (intent.getAction())) { 
// 当 防火 墙 状态 改变 时 马上 广播 信息 
final Bundle extras = intent.getExtras(); 
if (extras != null && extras.containsKey(Api.STATUS EXTRA)) ( 
final boolean firewallEnabled - extras 
.getBoolean(Api.STATUS EXTRA); 
final AppWidgetManager manager - AppWidgetManager 
-getInstance (context); 
final int[] widgetIds = manager 
-getAppWidgetIds (new ComponentName (context, 
StatusWidget.class)); 
showWidget (context, manager, widgetIds, firewallEnabled); 
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} else if (Api.TOGGLE REQUEST MSG.equals (intent.getAction())) { 
// 根据 防火 墙 开关 信息 广播 状态 信息 
final SharedPreferences prefs = context.getSharedPreferences( 
Api.PREFS NAME, 0); 
final boolean enabled = !prefs.getBoolean(Api.PREF ENABLED, true); 
final String pwd - prefs.getString(Api.PREF PASSWORD, ""); 
if (!enabled && pwd.length() != 0) ( 
Toast.makeText (context, 
"Cannot disable firewall - password defined!", 
Toast.LENGTH SHORT).show(); 
return; 
} 
final Handler toaster = new Handler() { 
public void handleMessage (Message msg) { 
if (msg.argl != 0) 
Toast.makeText (context, msg.argl, Toast.LENGTH SHORT 


-Show() ; 
} 
Me 
// 开 启 新 线程 改变 防火 墙 
new Thread() { 
GOverride 


public void run() ( 
final Message msg - new Message(); 
if (enabled) ( 
if (Api.applySavedIptablesRules (context, false)) ( 
msg.argl = R.string.toast enabled; 
toaster.sendMessage (msg) ; 
) else ( 
msg.argl = R.string.toast error enabling; 
toaster.sendMessage (msg) ; 
return; 
) 
) eise ( 
if (Api.purgeIptables (context, false)) { 
msg.argl = R.string.toast disabled; 
toaster.sendMessage (msg) ; 
) else { 
msg.argl = R.string.toast error disabling; 
toaster.sendMessage (msg) ; 
return; 


} 
Api.setEnabled (context, enabled); 
} 
}.start (); 


@override 
public void onUpdate (Context context, AppWidgetManager appWidgetManager, 


Android parsans 


intil lintsi { 
super.onUpdate (context, appWidgetManager, ints); 
final SharedPreferences prefs = context.getSharedPreferences( 
Api.PREFS NAME, 0); 
boolean enabled = prefs.getBoolean (Api.PREF ENABLED, true); 
showWidget (context, appWidgetManager, ints, enabled); 


private void showWidget (Context context, AppWidgetManager manager, 
int[] widgetIds, boolean enabled) { 
final RemoteViews views = new RemoteViews (context .getPackageName () ， 
R.layout.onoff widget); 
final int iconId = enabled ? R.drawable.widget on 
R.drawable.widget off; 
views .setImageViewResource (R.id.widgetCanvas, iconId); 
final Intent msg - new Intent(Api.TOGGLE REQUEST MSG); 
final PendingIntent intent = PendingIntent.getBroadcast (context, -1, 
msg, PendingIntent.FLAG UPDATE CURRENT); 
views.setoOnClickPendingIntent (R.id.widgetCanvas, intent); 
manager.updateAppWidget (widgetIds, views); 


} 


到 此 为 止 ， 整 个 网 络 流量 监控 系统 介绍 完毕 。 
14.6 系统 测试 


执行 后 的 主 界面 效果 如 图 14-5 所 示 ， 按 下 Menu 键 后 会 弹出 设置 选项 界面 ， 如 图 14-6 
所 示 。 


图 14-5 主 界面 图 14-6 设置 界面 
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单 击 设置 界面 中 的 Firewall disabled 选项 可 以 打开 /关闭 防火 墙 ， 单 击 设置 界面 中 区 
Log enabled 选项 可 以 打开 /关闭 日 志 ， 单 击 设置 界面 中 的 Save mles 选项 会 弹出 保存 进 
条 ， 如 图 14-7 所 示 。 

单 击 设置 界面 中 的 国 ) 按 钮 会 退出 当前 系统 ， 单 击 设置 界面 中 ioo 钮 会 弹出 帮助 界 
面 ， 如 图 14-8 所 示 ， 单 击 设置 界面 中 的 图 按钮 会 弹出 一 个 新 功能 界面 ， 如 图 14-9 所 示 。 
在 此 界面 中 可 以 选择 实现 其 他 功能 ， 例 如 单 击 Set password 选项 后 会 弹出 一 个 设置 密码 界 
面 ， 如 图 14-10 所 示 。 


@® proidwallv1.5.1b 


Using DroidWall: 
1. Click on Mode 


finca 


14-7 ”保存 规则 进度 条 14-8 帮助 界面 


Set password lock 
Show log 


(leave blank 


Show rules 


Clear log 


|o | Cancel 


图 14-9 新 功能 界面 图 14-10 设置 密码 界面 


.第 15 章 
Aneroid 网 络 典 型 应 用 实践 


经 过 本 书 前 面 内 容 的 学 习 ，Android 网 络 开发 技术 已 经 讲 
解 完毕 。 本 章 将 详细 介绍 Android 在 网 络 领域 的 常用 模块 ， 不 
但 探讨 了 新 技术 ， 而 且 对 前 面 的 内 容 进 行 一 个 整体 回顾 ， 对 所 
学 知识 进行 一 个 拔高 处 理 。 希 望 通过 对 这 些 知 识 点 的 学 习 ， 使 


自己 的 水 平 得 到 一 个 质 的 提高 。 
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15.1 测试 网 络 下 载 速 度 


目前 用 户 比 较 关 心 网 速 的 问题 ， 大 家 都 不 喜欢 用 极 慢 的 速度 下 载 自己 心仪 的 电影 。 所 
以 在 Android 平台 中 ， 很 有 必要 开发 一 个 网 速 测试 程序 。 在 接 下 来 的 演示 代码 中 ， 将 通过 
下 载 文件 的 大 小 和 当前 读 取 的 字 节 数 ， 在 固定 的 时 间 中 检测 网 络 速度 。 

(1) 定义 网 络 信息 类 NetWorkSpeedInfo， 其 中 设置 了 需要 的 常量 值 。 

package cc.androidos.speed; 


public class NetWorkSpeedInfo 
t 


/**Network speed*/ 

public long speed = 0; 

/**Had finished bytes*/ 

public long hadFinishedBytes - 0; 

/**Total bytes of a file, default is 1024 bytes,lK*/ 
public long totalBytes = 1024; 


/**The net work type, 3G or GSM and so on*/ 
public int networkType - 0; 


/**Down load the file percent 0----100*/ 
public int downloadPercent - 0; 
} 


Q) 编写 一 个 名 为 SpeedActivity 的 主 Activity， 实 现 获取 速度 操作 。 


package cc.androidos.speed; 
import android.app.Activity; 
import android.graphics.Bitmap; 
import android.graphics.BitmapFactory; 
import android.os.Bundle; 
import android.os.Handler; 
import android.os.Message; 
import android.util.Log; 
import android.view.View; 
import android.widget.Button; 
import android.widget.ImageView; 
import android.widget.TextView; 
public class SpeedActivity extends Activity 
{ 
/** Called when the activity is first created. */ 


TextView fileLength = null; 
TextView speed = null; 
TextView hasDown = null; 
TextView percent = null; 
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String url = "7; 
ImageView imageView = null; 
byte[] imageData = null; 


NetWorkSpeedInfo netWorkSpeedInfo = null; 
private final int UPDATE SPEED = 1; 
@Override 
public void onCreate( Bundle savedInstanceState ) 
t 
super.onCreate( savedInstanceState ); 
setContentView( R.layout.main ); 


hasDown = ( TextView ) findViewById( R.id.hasDown ); 
fileLength = ( TextView ) findViewById( R.id.fileLength ); 
speed - ( TextView ) findViewById( R.id.speed ); 

percent - ( TextView ) findViewById( R.id.percent ); 
imageView = ( ImageView ) findViewById( R.id.ImageView0l ); 
Button b = ( Button ) findViewById( R.id.Button0l ); 


url = getString( R.string.image url ); 
netWorkSpeedInfo - new NetWorkSpeedInfo(); 
b.setOnClickListener( new View.OnClickListener () 
{ 

@override 

public void onClick( View argO ) 

{ 


//down load the file thread 
new Thread() 
{ 

@override 

public void run() 


{ 
imageData = ReadFile.getFileFromUrl( url, 


netWorkSpeedInfo ); 
stop (); 
} 
} .start() 


//get the speed , down load bytes ,update the view thread 
new Thread() 


t 
@override 
public void run() 


{ 


while ( netWorkSpeedInfo.hadFinishedBytes < 
netWorkSpeedInfo.totalBytes ) 


netWorkSpeedInfo.downloadPercent — ( int ) 
(( ( double ) netWorkSpeedInfo.hadFinishedBytes / 
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( double ) netWorkSpeedInfo.totalBytes ) * 100); 
try 
t 


sleep( 1500 ); 
} 
catch ( InterruptedException e ) 


il 
e.printStackTrace(); 


Log.e( "update,send the message to update", "" ); 
//update view 
handler.sendEmptyMessage( UPDATE SPEED ); 


//finished 
if( netWorkSpeedInfo.hadFinishedBytes == 
netWorkSpeedInfo.totalBytes ) 


netWorkSpeedInfo.downloadPercent = ( int ) 

(€ ( double ) netWorkSpeedInfo.hadFinishedBytes / 

( double ) netWorkSpeedInfo.totalBytes ) * 100); 
handler.sendEmptyMessage( UPDATE SPEED ); 
Log.e( "update", 

",send the message to update and stop" ); 


stop); 
) 
) 
).start(); 
} 
y» 
H 
[** 
* Handler for post message into OS 
7 


private Handler handler - new Handler() 
t 
GOverride 
public void handleMessage( Message msg ) 
t 
int value - msg.what; 
switch ( value ) 
t 
case UPDATE SPEED: 
updateView(); 
break; 
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default: 
break; 


/[** 
* Update the view method 
t 
private void updateView() 
t 
Speed.setText( netWorkSpeedInfo.speed + "bytes/s" ); 
hasDown.setText( netWorkSpeedInfo.hadFinishedBytes + "bytes" ); 
fileLength.setText( netWorkSpeedInfo.totalBytes + "" ); 
percent.setText( netWorkSpeedInfo.downloadPercent+"%" ); 
if( imageData !- null 
t 
Bitmap b = BitmapFactory.decodeByteArray( imageData, 0, 
imageData.length ); 
imageView.setImageBitmap( b ); 


) 
G) 编写 读 取 指定 Web 文件 的 代码 ， 用 于 通过 读 取 指定 的 文件 来 测试 速度 。 


package cc.androidos.speed; 

import java.io.InputStream; 

import java.net.URL; 

import java.net.URLConnection; 

import android.util.Log; 

public class ReadFil( 

public static byte[] getFileFromUrl( String url,NetWorkSpeedInfo 

netWorkSpeedInfo ) 


int currentByte = 0; 
int fileLength - 0; 

long startTime - 0; 

long intervalTime - 

byte[] b = null; 


0; 


int bytecount - 0; 
URL urlx - null; 
URLConnection con - null; 
InputStream stream = null; 
tr i 
Log.d( "URL:", url ):; 
urlx = new URL( url ); 
con = urlx.openConnection(); 
con.setConnectTimeout ( 20000 ); 
con.setReadTimeout( 20000 ); 
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fileLength — con.getContentLength(); 
stream = con.getInputStream(); 
netWorkSpeedInfo.totalBytes = fileLength; 
b = new byte[fileLength]; 
startTime = System.currentTimeMillis(); 
while ( ( currentByte = stream.read() ) != -1 ) 
t 
netWorkSpeedInfo.hadFinishedBytes++; 
intervalTime = System.currentTimeMillis() - startTime; 
if (intervalTime==0) { 
netWorkSpeedInfo.speed = 1000; 
Jelset 
netWorkSpeedInfo.speed = ( netWorkSpeedInfo. 
hadFinishedBytes / intervalTime ) * 1000; 
} 
if (bytecount<fileLength) { 
b[bytecount++] = ( byte ) currentByte; 
} 
} 
} 
catch ( Exception e ) 
t 
Log.e( "exception : ", e.getMessage()+"" ); 
} 
finall { 
tr t 
if( stream !- null ) 
t 
stream.close(); 
) 
} 
catch ( Exception e ) 
{ 
Log.e( "exception : ", e.getMessage() ); 
} 
H 
return b; 


15.2 Wit Handler 实现 异步 消息 处 理 


在 Android 系统 中 ， 可 以 与 服务 端 实现 HTTP 通信 ， 并 解析 XML 数据 ， 通 过 Handler 
实现 异步 消息 处 理 。 在 接 下 来 的 演示 代码 中 ， 分 别 实现 了 以 下 三 个 重要 操作 。 

(1) HTTP 通信 : 与 服务 端 做 HTTP 通信 ， 分 别 以 Get 方式 和 Post 方式 做 演示 。 

(2) XML 解析 : 可 以 用 两 种 方式 解析 XML， 分 别 是 DOM 方式 和 SAX 方式 。 
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(3) 异步 消息 处 理 : 通过 Handler 实现 异步 消息 处 理 ， 以 一 个 自 定义 的 异步 下 载 类 来 说 
明 Handler 的 用 法 。 


15.2.1 实现 HTTP 通 信和 XML 解析 的 演示 


(1) 定义 一 个 名 为 MySAXHandler 的 类 ， 此 类 继承 于 DefaultHandler， 功 能 是 实现 指定 
XML 的 SAX 解析 器 。 并 且 在 下 面 的 代码 中 使 用 了 SAX 流 式 解析 方式 ， 通 过 事件 模型 解 
析 XML， 这 种 方式 只 能 顺序 解析 。 


package com.webabcd.communication; 


import org.xml.sax.Attributes; 

import org.xml.sax.SAXException; 

import org.xml.sax.helpers.DefaultHandler; 

// 采用 DOM - w3c 标准 ， 需 要 把 XML 数据 全 部 加 载 完成 后 才能 对 其 做 解析 ， 可 对 树 做 任意 遍历 
public class MySAXHandler extends DefaultHandler ( 


private boolean mIsTitleTag - false; 
private boolean mIsSalaryTag - false; 
private boolean mIsBirthTag - false; 
private String mResult - ""; 


// 打开 XML 文档 的 回调 函数 

@override 

public void startDocument() throws SAXException { 
// TODO Auto-generated method stub 
super.startDocument () ; 

} 


// 关闭 XML 文档 的 回调 函数 

GOverride 

public void endDocument() throws SAXException ( 
// TODO Auto-generated method stub 
super.endDocument () ; 

} 


// 发 现 元 素 开始 标记 就 回调 此 函数 
@Override 
public void startElement (String uri, String localName, String qName, 
Attributes attributes) throws SAXException { 
if (localName == "title") 
mIsTitleTag = true; 
else if (localName -- "salary") 
mIsSalaryTag = true; 
else if (localName == "dateOfBirth") 
mIsBirthTag - true; 
else if (localName == "employee") 
mResult += "\nname:" + attributes.getValue ("name"); 
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// 发 现 元 素 结束 标记 就 回调 此 函数 
@override 
public void endElement (String uri, String localName, String qName) 
throws SAXException { 
if (localName == "title") 
mIsTitleTag = false; 
else if (localName == "salary") 
mIsSalaryTag = false; 
else if (localName == "dateOfBirth") 
mIsBirthTag = false; 


) 


// 发 现 元 素 值 或 属性 值 就 回调 此 函数 
GOverride 
public void characters(char[] ch, int start, int length) 
throws SAXException ( 
if (mIsTitleTag) 
mResult += new String(ch, start, length); 
else if (mIsSalaryTag) 
mResult += " salary:" + new String(ch, start, length); 
else if (mIsBirthTag) 
mResult += " dateOfBirth:" + new String(ch, start, length); 


public String getResult()( 
return mResult; 


) 

Q) 在 下 面 的 演示 代码 中 主要 定义 了 以 下 两 个 核心 方法 。 

方法 httpGetDemo(): 以 HTTP 协议 的 get0 方 法 获取 远程 页 面 响应 的 内 容 。 

方法 httpPostDemoQ: 以 HTTP 协议 的 post0 方 法 向 远程 页 面 传递 参数 ， 并 获取 其 响应 
的 内 容 。 


package com.webabcd.communication; 


import java.io.BufferedInputStream; 
import java.io.BufferedReader; 
import java.io.IOException; 

import java.io.InputStream; 

import java.io.InputStreamReader; 
import java.net.HttpURLConnection; 
import java.net.URL; 

import java.net.URLConnection; 
import java.util.ArrayList; 

import java.util.HashMap; 

import java.util.Map; 


import javax.xml.parsers.DocumentBuilder; 
import javax.xml.parsers.DocumentBuilderFactory; 


import 
import 


import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 


import 
import 
import 
import 
import 


public 
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javax.xml.parsers.SAXParser; 
javax.xml.parsers.SAXParserFactory; 


org.apache.http.HttpEntity; 
org.apache.http.HttpResponse; 
org.apache.http.client.entity.UrlEncodedFormEntity; 
org.apache.http.client.methods.HttpPost; 
org.apache.http.impl.client.DefaultHttpClient; 
org.apache.http.message.BasicNameValuePair; 
org.apache.http.protocol.HTTP; 
org.apache.http.util.ByteArrayBuffer; 
org.apache.http.util.EncodingUtils; 
org.w3c.dom.Document; 

org.w3c.dom.Element; 

org.w3c.dom.NodeList; 

org.xml.sax.InputSource; 
org.xml.sax.XMLReader; 


android.app.Activity; 
android.os.Bundle; 
android.view.View; 
android.widget.Button; 
android.widget.TextView; 


class Main extends Activity { 


private TextView textView; 


/** Called when the activity is first created. */ 
@override 
public void onCreate (Bundle savedInstanceState) { 


super .onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 


textView = (TextView) this.findViewById(R.id.textView) ; 


Button btnl = (Button) this.findViewById(R.id.btn1) ; 
btnl.setText ("http get demo"); 
btnl.setOnClickListener (new Button.OnClickListener () 
public void onClick(View v) { 
httpGetDemo () ; 


he 


Button btn2 = (Button) this.findViewById(R.id.btn2); 
btn2.setText("http post demo"); 
btn2.setOnClickListener (new Button.OnClickListener() 
public void onClick(View v) { 
httpPostDemo(); 
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Button btn3 = (Button) this.findViewById(R.id.btn3); 
// DOM - Document Object Model 
btn3.setText ("DOM 解析 XML"); 
btn3.setOnClickListener(new Button.OnClickListener() { 
public void onClick(View v) ( 
DOMDemo () ; 


n: 


Button btn4 = (Button) this.findViewById(R.id.btn4) ; 
// SAX - Simple API for XML 
btn4.setText("SAX 解析 XML"); 
btn4.setOnClickListener(new Button.OnClickListener() ( 

public void onClick(View v) ( 

SAXDemo () ; 

) 

H); 


// Android 调用 http 协议 的 Get 方法 
// 本 例 : 以 HTTP 协议 的 Get 方法 获取 远程 页 面 响应 的 内 容 
private void httpGetDemo() { 
try ( 
// 模拟 器 测试 时 ， 请 使 用 外 网 地 址 
URL url = new URL("http://XXX.XXX.XXX"); 
URLConnection con = url.openConnection(); 


String result = "http status code: " + 
((HttpURLConnection)con).getResponseCode() + "Wn"; 
// HttpURLConnection.HTTP OK 


InputStream is = con.getInputStream(); 

BufferedInputStream bis = new BufferedInputStream(is) ; 

ByteArrayBuffer bab = new ByteArrayBuffer (32); 

int current - 0; 

while ( (current = bis.read()) != -1 )( 
bab.append( (byte) current); 

H 

result += EncodingUtils.getString(bab.toByteArray(), HTTP.UTF 8); 


bis.close(); 
is.close(); 


textView.setText (result); 
) catch (Exception e) { 
textView.setText (e.toString()); 


} 


// Android 调用 HTTP 协议 的 Post 方法 
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// 本 例 : 以 HTTP 协议 的 Post 方法 向 远程 页 面 传递 参数 ， 并 获取 其 响应 的 内 容 
private void httpPostDemo() { 
try ( 
// 模拟 器 测试 时 ， 请 使 用 外 网 地 址 
String url = "http://5billion.com.cn/post.php"; 
Map<String, String» data = new HashMap<String, String» (); 
data.put("name", "webabcd"); 
data.put("salary", "100"); 


DefaultHttpClient httpClient = new DefaultHttpClient (); 
HttpPost httpPost = new HttpPost (url); 
ArrayList«BasicNameValuePair» postData - new 
ArrayList«BasicNameValuePair»(); 
for (Map.Entry<String, String» m : data.entrySet()) { 
postData.add(new BasicNameValuePair (m.getKey(), 
m.getValue())); 


UrlEncodedFormEntity entity = new 
UrlEncodedFormEntity(postData, HTTP.UTF 8); 
httpPost.setEntity (entity); 


HttpResponse response - httpClient.execute (httpPost); 


String result = "http status code: " + 
response.getStatusLine().getStatusCode() + "An"; 
// HttpURLConnection.HTTP OK 


HttpEntity httpEntity = response.getEntity(); 


InputStream is = httpEntity.getContent (); 
result += convertStreamToString (is); 


textView.setText (result) ; 
} catch (Exception e) { 
textView.setText (e.toString()); 


} 


// 以 Dom 方式 解析 XML 
private void DOMDemo () { 
try { 
DocumentBuilderFactory docFactory = 
DocumentBuilderFactory.newInstance(); 
DocumentBuilder docBuilder = docFactory.newDocumentBuilder () ; 
Document doc = docBuilder.parse (this.getResources(). 
openRawResource (R. raw.employee)); 
Element rootElement = doc.getDocumentElement (); 
NodeList employeeNodeList = rootElement.getElementsByTagName 
("employee"); 


Andicid 54555283 


textView.setText ("DOMDemo" + "\n"); 
String title = rootElement.getElementsByTagName ("title"). 
item(0).getFirstChild().getNodeValue(); 
textView.append(title); 
for (int i-0; i«employeeNodeList.getLength(); i++) { 
Element employeeElement = ((Element)employeeNodeList.item(i)); 
String name = employeeElement.getAttribute ("name"); 
String salary - employeeElement.getElementsByTagName 
("salary").item(0).getFirstChild().getNodeValue|(); 
String dateOfBirth - employeeElement.getElementsByTagName 
("dateOfBirth").item(0).getFirstChild().getNodeValue(); 
textView.append("\nname: "+name+" salary: "+salary+" 
dateOfBirth: " + dateOfBirth); 


} 
} catch (Exception e) { 
textView.setText (e.toString()); 


// 以 SAX 方式 解析 XML 
private void SAXDemo(){ 
try í 
SAXParserFactory saxFactory - SAXParserFactory.newInstance(); 
SAXParser parser - saxFactory.newSAXParser(); 
XMLReader reader = parser.getXMLReader () ; 


MySAXHandler handler - new MySAXHandler(); 
reader.setContentHandler (handler); 
reader.parse(new InputSource (this.getResources () .openRawResource 
(R.raw.employee))); 
String result - handler.getResult(); 
textView.setText("SAXDemo" + "\n"); 
textView. append (result); 
} catch (Exception e) { 
textView.setText (e.toString()); 


f 


// 辅助 方法 ， 用 于 把 流转 换 为 字符 串 

private String convertStreamToString(InputStream is) ( 
BufferedReader reader = new BufferedReader (new InputStreamReader (is) ); 
StringBuilder sb = new StringBuilder (); 


String line = null; 
try { 
while ((line = reader.readLine()) != null) { 
sb.append(line + "\n"); 
H 
) catch (IOException e) ( 
e.printStackTrace(); 
) finally ( 
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try { 
is.close(); 
) catch (IOException e) ( 
e.printStackTrace(); 
5 
} 
return sb.toString(); 


15.2.2 ”使 用 Handler 实 现 异步 消息 处 理 


当 用 Handler 实现 异步 消息 处 理 时 ， 在 接 下 来 的 演示 代码 中 ， 以 一 个 可 以 实时 汇报 下 
载 进度 的 异步 下 载 类 为 例 ， 开 发 了 一 个 Android 类 库 。 在 以 下 演示 代码 中 此 类 库 的 名 字 为 
webabcd util。 打 开 Eclipse， 依 次 选择 New | Java Project 命令 ， 然 后 在 项 目 上 右 击 并 依次 
选择 Build Path | Add Libraries | User Library | User Libraries | New 命令 ， 为 类 库 起 一 个 名 
字 ， 然 后 选中 这 个 类 库 ， 单 击 Add JARs 导入 Android 的 jar 包 。 最 后 在 项 目 上 右 击 ， 依 
次 选择 Build Path | Add Libraries | User Library 命令 ， 选 择 Android 库 。 


package webabcd.util; 


import 
import 
import 
import 
import 
import 
import 


import 
import 


import 
import 


java.io.BufferedReader; 
java.io.File; 
java.io.FileOutputStream; 
java.io.InputStream; 
java.io.InputStreamReader; 
java.net.URL; 

java.net .URLConnection; 


org.apache.http.protocol.HTTP; 
android.os.Handler; 


android.os.Message; 
android.util.Log; 


// 以 一 个 异步 下 载 实例 ， 来 演示 Android 的 异步 消息 处 理 (用 Handler 的 方式 ) 


public 


class DownloadManagerAsync { 


public DownloadManagerAsync() { 


} 


// 实例 化 自 定义 的 Handler 


EventHandler mHandler = new EventHandler (this); 


// 按 指定 URL 地 址 下 载 文件 到 指定 路 径 
public void download(final String url, final String savePath) { 


new Thread(new Runnable() ( 
public void run() ( 
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EEY OI 
sendMessage (FILE DOWNLOAD CONNECT); 
URL sourceUrl = new URL (url); 
URLConnection conn - sourceUrl.openConnection(); 
InputStream inputStream - conn.getInputStream(); 
int fileSize = conn.getContentLength (); 
File savefile = new File(savePath); 
if (savefile.exists()) ( 
savefile.delete(); 
} 
savefile.createNewFile(); 


FileOutputStream outputStream = new FileOutputStream( 
savePath, true); 
byte[] buffer - new byte[1024]; 
int readCount - 0; 
int readNum = 0; 
int prevPercent - 0; 
while (readCount « fileSize && readNum !- -1) ( 
readNum = inputStream.read (buffer); 
if (readNum » -1) ( 
outputStream.write (buffer); 
readCount = readCount + readNum; 


int percent = (int) (readCount * 100 / fileSize); 
if (percent » prevPercent) ( 
// 发 送 下 载 进度 信息 
sendMessage (FILE DOWNLOAD UPDATE, percent, 
readCount); 


prevPercent - percent; 


} 

outputStream.close(); 

sendMessage (FILE DOWNLOAD COMPLETE, savePath); 
) catch (Exception e) ( 

sendMessage (FILE DOWNLOAD ERROR, e); 

Log.e("MyError", e.toString()); 


} 
)).start(); 


} 

// 读 取 指定 URL 地 址 的 响应 内 容 

public void download(final String url) ( 

new Thread(new Runnable() ( 
public void run() ( 
try { 

sendMessage (FILE DOWNLOAD CONNECT) ; 
URL sourceUrl = new URL(url); 
URLConnection conn = sourceUrl.openConnection () ; 
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conn.setConnectTimeout (3000); 
BufferedReader reader = new BufferedReader( 
new InputStreamReader (conn.getInputStream(), 
HTTP.UTF 8)); 

String line - null; 

StringBuffer content = new StringBuffer(); 

while ((line = reader.readLine()) !- null) ( 

content .append (line) ; 

} 

reader.close(); 

sendMessage (FILE DOWNLOAD COMPLETE, content.toString()); 
) catch (Exception e) ( 

sendMessage (FILE DOWNLOAD ERROR, e); 

Log.e("MyError", e.toString()); 


p 
)).start(); 


) 
// 向 Handler 发 送 消息 
private void sendMessage(int what, Object obj) ( 
// 构造 需要 向 Handler 发 送 的 消息 
Message msg = mHandler.obtainMessage (what, obj); 
// 发 送 消息 
mHandler.sendMessage (msg) ; 
) 
private void sendMessage(int what) ( 
Message msg - mHandler.obtainMessage (what); 
mHandler.sendMessage (msg) ; 
) 
private void sendMessage(int what, int argl, int arg2) ( 
Message msg - mHandler.obtainMessage(what, argl, arg2); 
mHandler.sendMessage (msg) ; 
) 
private static final int FILE DOWNLOAD CONNECT - 0; 
private static final int FILE DOWNLOAD UPDATE - 1; 
private static final int FILE DOWNLOAD COMPLETE = 2; 
private static final int FILE DOWNLOAD ERROR - -1; 
// 自 定义 的 Handler 
private class EventHandler extends Handler ( 
private DownloadManagerAsync mManager; 
public EventHandler(DownloadManagerAsync manager) ( 
mManager = manager; 


H 

// 处 理 接收 到 的 消息 

GOverride 

public void handleMessage (Message msg) ( 
switch (msg.what) ( 
case FILE DOWNLOAD CONNECT: 


if (mOnDownloadConnectListener != null) 
monDownloadConnectListener.onDownloadConnect (mManager); 
break; 
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case FILE DOWNLOAD UPDATE: 


if (mOnDownloadUpdateListener != null) 
mOnDownloadUpdateListener .onDownloadUpdate (mManager, 
msg.argl); 
break; 
case FILE DOWNLOAD COMPLETE: 
if (mOnDownloadCompleteListener != null) 
monDownloadCompleteListener.onDownloadComplete (mManager, 
msg.obj); 
break; 
case FILE DOWNLOAD ERROR: 
if (mOnDownloadErrorListener !- null) 


monDownloadErrorListener.onDownloadError (mManager, 
(Exception) msg.obj); 
break; 
default: 
break; 


) 


) 

// 定义 连接 事件 

private OnDownloadConnectListener mOnDownloadConnectListener; 

public interface OnDownloadConnectListener ( 
void onDownloadConnect (DownloadManagerAsync manager); 

) 

public void setonDownloadConnectListener (OnDownloadConnectListener listener) ( 
mOnDownloadConnectListener = listener; 


} 

// 定义 下 载 进度 更 新 事件 

private OnDownloadUpdateListener mOnDownloadUpdateListener; 

public interface OnDownloadUpdateListener ( 
void onDownloadUpdate (DownloadManagerAsync manager, int percent); 

) 

public void setOnDownloadUpdateListener (OnDownloadUpdateListener listener) ( 
monDownloadUpdateListener - listener; 


) 
// 定义 下 载 完成 事件 
private OnDownloadCompleteListener mOnDownloadCompleteListener; 
public interface OnDownloadCompleteListener ( 
void onDownloadComplete (DownloadManagerAsync manager, Object result); 
} 
public void setOnDownloadCompleteListener ( 
OnDownloadCompleteListener listener) ( 
monDownloadCompleteListener = listener; 


} 
// 定义 下 载 异常 事件 
private OnDownloadErrorListener mOnDownloadErrorListener; 
public interface OnDownloadErrorListener { 
void onDownloadError (DownloadManagerAsync manager, Exception e); 


} 
public void setOnDownloadErrorListener (OnDownloadErrorListener 


0B 第 15 章 Android 网 络 典型 应 用 实践 


listener) ( 
monDownloadErrorListener = listener; 


5 
然后 调用 上 面 的 自 定义 的 Android 类 库 ， 在 项 目 上 右 击 ， 依 次 选择 Properties | Java 
Build Path | Projects | Add 命令 来 引用 上 面 的 类 库 。 


package com.webabcd.handler; 


import android.app.Activity; 
import android.os.Bundle; 
import android.widget.TextView; 


import webabcd.util.DownloadManagerAsync; 


public class Main extends Activity implements 
DownloadManagerAsync.OnDownloadCompleteListener, 
DownloadManagerAsync.OnDownloadUpdateListener, 
DownloadManagerAsync.OnDownloadErrorListener ( 


TextView txt; 


/** Called when the activity is first created. */ 

@override 

public void onCreate (Bundle savedInstanceState) { 
super .onCreate (savedInstanceState); 
setContentView (R.layout.main) ; 


DownloadManagerAsync manager = new DownloadManagerAsync(); 

manager .setOnDownloadCompleteListener (this); 

manager. setOnDownloadUpdateListener (this); 

manager .download ("http://files.cnblogs.com/webabcd/Android.rar", 
"/sdcard/Android.rar"); 

txt = (TextView) this.findViewById(R.id.txt); 

txt.setText ("开始 下 载 "); 


public void onDownloadComplete (DownloadManagerAsync manager, Object result) { 


txt.setText (" 下 载 完成 ") ; 


public void onDownloadUpdate (DownloadManagerAsync manager, int percent) ( 


txt.setText (" 下 载 进度 : " + String.valueOf(percent) + "$"); 


public void onDownloadError (DownloadManagerAsync manager, Exception e) { 
txt.setText (" 下 载 出 错 ") ; 
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} 
$ 


15.3 ”实现 网 络 多 线程 断 点 下 载 


在 现实 应 用 中 ， 直 接 使 用 单线 程 下 载 HTTP. 文件 对 我 们 来 说 是 一 件 非常 简单 的 事 。 其 
实 我 们 可 以 尝试 使 用 多 线程 断 点 进行 下 载 。 本 节 将 通过 一 个 具体 实例 来 讲解 在 Android 中 
实现 网 络 多 线程 断 点 下 载 的 方法 。 


15.3.1 实现 原理 


要 想 从 文件 的 指定 位 置 处 开始 下 载 文件 ， 可 以 通过 HTTP 请 求 信息 头 来 设置 ， 需 要 设 
置 HTTP 请 求 信息 头 的 Range 属性 。 在 解决 了 多 线程 下 载 问题 后 ， 接 下 来 开始 解决 支持 断 
点 下 载 的 问题 。 其 实 很 简单 ， 只 需 将 下 载 的 进度 保存 到 文件 中 即 可 ， 但 是 在 Android 中 却 
不 能 这 么 做 。 在 Android 平台 中 ， 我 们 需要 向 文件 中 写 入 下 载 的 文件 数据 ， 还 需要 向 另 一 
个 文件 中 写 入 下 载 进度 ， 这 样 会 导致 有 一 个 文件 的 内 容 没 有 被 写 入 的 错误 。 所 以 我 们 就 不 
能 以 文件 的 方式 来 保存 下 载 进度 ， 但 可 以 通过 数据 库 的 方式 保存 下 载 进度 。 


15.3.2 具体 实现 


(1) 创建 Android 工程 。 

Project name: MulThreadDownloader. 

BuildTarget: Android 4.0. 

Application name: 多 线程 断 点 下 载 。 

Package name: com.changcheng.download. 

Create Activity: MulThreadDownloader. 

Min SDK Version: 11. 

(2) 编写 文件 AndroidManifestxml， 在 此 文件 中 主要 设置 以 下 三 个 权限 。 
O ”在 SDCard 中 创建 与 删除 文件 权限 。 

ü fkSDCard 中 写 入 数据 权限 。 

Q ”访问 Internet 权限 。 

具体 代码 如 下 : 

«?xml version-"1.0" encoding-"utf-8"?» 

«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 


package-"com. changcheng.download" 
android:versionCode-"1" 


android:versionName-"1.0"» 
«application android:icon="@drawable/icon" 
android:label-"8string/app name"» 
«activity android:name-".MulThreadDownloader" 
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android: label="@string/app name"> 
«intent-filter» 
«action android:name-"android.intent.action.MAIN" /» 
«category android:name-"android.intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 
</application> 
«uses-sdk android:minSdkVersion="20" /> 
«1-- f£ sDCard 中 创建 与 删除 文件 权限 --> 
<uses-permission android:name-"android.permission.MOUNT 
UNMOUNT FILESYSTEMS"/» 
<!-- 往 SDCard 中 写 入 数据 权限 --> 
<uses-permission android:name-"android.permission.WRITE 
EXTERNAL STORAGE"/» 
<!-- 访问 Internet 权限 --> 
<uses-permission android:name="android.permission.INTERNET"/> 
</manifest> 


(3) 编写 文件 strings.xml， 具 体 代 码 如 下 : 


«?xml version-"1.0" encoding="utf-8"?> 
«resources» 
«string name="hello">Hello World, DownloadActivity!«/string» 
«string name-"app name"> 多 线程 断 点 下 载 </string> 
«string name="path"> 下 载 路 径 </string> 
«string downloadbutton"» F&</string> 
«string name-"sdcarderror"»SDCard 不 存在 或 者 写 保 护 </string> 
</resources> 


(4) 编写 UI 布局 文件 main.xml， 具 体 代 码 如 下 : 


<?xml version-"1.0" encoding-"utf-8"?» 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="fill parent" 
android:layout height-"fill parent" 
> 
<! 下 载 路 径 > 
<TextView 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text="@string/path" 
Js 
<EditText 
android:layout width="fill parent" 
android:layout height="wrap content" 
android: text="http: //www.winrar.com.cn/download/wrar380sc.exe" 
android: id="@+id/path” 
/> 
<!-- 下 载 按钮 --> 
«Button 
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android:layout width-"wrap content" 
android:layout height-"wrap content" 
android: text="@string/downloadbutton"” 
android: id="@+id/button"” 
/> 
<!-- 进度 条 --> 
<ProgressBar 
android:layout width="fill parent" 
android:layout height-"20dip" 
style-"?android:attr/progressBarStyleHorizontal" 
android: id="@+id/downloadbar"/> 
<!-- 进度 $ --> 
<TextView 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:gravity-"center" 
android: id="@+id/resultView" 
/> 
</LinearLayout> 


(5) 编写 文件 MulThreadDownloader.java， 具 体 代码 如 下 : 


package com.changcheng.download; 
import java.io.File; 
import com.changcheng.net.download.DownloadProgressListener; 
import com.changcheng.net.download.FileDownloader; 
import com.changcheng.download.R; 
import android.app.Activity; 
import android.os.Bundle; 
import android.os.Environment; 
import android.os.Handler; 
import android.os.Message; 
import android.view.View; 
import android.widget.Button; 
import android.widget.EditText; 
import android.widget.ProgressBar; 
import android.widget.TextView; 
import android.widget.Toast; 
public class MulThreadDownloader extends Activity { 
private EditText pathText; 
private ProgressBar progressBar; 
private TextView resultView; 
private Handler handler - new Handler()( 
@override 
public void handleMessage (Message msg) { 
if (!Thread.currentThread() .isInterrupted() ) { 
switch (msg.what) { 
case 1: 
// 获取 当前 文件 下 载 的 进度 
int size = msg.getData().getInt ("size"); 
progressBar.setProgress (size); 
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int result = (int) (((float)size/(float) 
progressBar.getMax()) * 100); 
resultView.setText (result+ "$"); 
if (progressBar.getMax() == size) { 
Toast.makeText (MulThreadDownloader. 
this, "XF FEX", 1).show(); 
) 
break; 
case -1: 
String error - msg.getData(). 
getString ("error"); 
Toast.makeText (MulThreadDownloader. 
this, error, 1).show(); 
break; 


} 
super .handleMessage (msg) ; 


n 
@override 
public void onCreate (Bundle savedInstanceState) { 
super .onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 
pathText = (EditText) this. findViewById(R.id.path) ; 
progressBar = (ProgressBar) this.findViewById(R.id.downloadbar) ; 
resultView = (TextView) this.findViewById(R.id.resultView) ; 
Button button = (Button) this.findViewById(R.id.button) ; 
button.setOnClickListener (new View.OnClickListener() { 
@override 
public void onClick(View v) { 
String path = pathText.getText().toString(); 
if (Environment .getExternalStorageState() .equals 
(Environment .MEDIA MOUNTED) ) { 
// 下 载 文件 需要 很 长 的 时 间 ， 主 线程 是 不 能 够 长 时 间 被 阻塞 ， 如 果 主线 程 被 长 时 间 
BASE, ABA Android 被 回收 应 用 
download (path, Environment.getExternalStorageDirectory()); 
}else{ 
Toast.makeText (MulThreadDownloader.this, 
R.string.sdcarderror, 1).show(); 


[** 
* 下 载 文件 
* @param path 下 载 路 径 
* @param saveDir 文件 保存 目录 
ER 
// 对 于 Android 的 U 控件 ， 只 能 由 主线 程 负责 显示 界面 的 更 新 ， 其 他 线程 不 能 直接 更 新 UI 控件 的 显示 
public void download(final String path, final File saveDir)( 
new Thread(new Runnable() ( 
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@override 
public void run() { 
FileDownloader downer = new FileDownloader 
(MulThreadDownloader.this, path, saveDir, 3); 
progressBar.setMax (downer.getFileSize()); 
// 设 置 进度 条 的 最 大 刻度 
ry 
downer.download (new DownloadProgressListener () { 
@override 
public void onDownloadSize(int size) { 
Message msg = new Message (); 
msg.what = 1; 
msg.getData().putInt("size", size); 
handler.sendMessage (msg) ; / / RIŽ ili f. 
bh); 
} catch (Exception e) { 
Message msg = new Message(); 
msg.what = -1; 
msg.getData().putString("error", "下载 失败 "); 
handler.sendMessage (msg) ; 


) 
start) 


} 
(6) 编写 文件 FileDownloadjava， 具 体 代 码 如 下 : 


package com.changcheng.net.download; 

import java.io.File; 

import java.io.RandomAccessFile; 

import java.net.HttpURLConnection; 

import java.net.URL; 

import java.util.LinkedHashMap; 

import java.util.Map; 

import java.util.UUID; 

import java.util.concurrent.ConcurrentHashMap; 

import java.util.regex.Matcher; 

import java.util.regex.Pattern; 

import com.changcheng.download.service.FileService; 

import android.content.Context; 

import android.util.Log; 

/** 

* 文件 下 载 器 

gi 

public class FileDownloader { 
private Context context; 
private FileService fileService; 
private static final String TAG = "FileDownloader"; 
/* BERRA */ 


private int downloadSize = 0; 
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/* 原始 文件 大 小 */ 


private int fileSize = 0; 
/* 线程 数 */ 
private DownloadThread[] threads; 
/* 下 载 路 径 */ 
private URL url; 
/* 本 地 保存 文件 */ 
private File saveFile; 
/二 下载 记录 文件 */ 
private File logFile; 
/* 缓存 各 线程 最 后 下 载 的 位 置 */ 
private Map<Integer, Integer» data = new 
ConcurrentHashMap«Integer, Integer>(); 
/* 每 条 线程 下 载 的 大 小 */ 
private int block; 
private String downloadUrl;// 下 载 路 径 
[** 
* 获取 线程 数 
E 
public int getThreadSize() ( 
return threads.length; 
} 
[** 
* 获取 文件 大 小 
* (return 
S) 
public int getFileSize() ( 
return fileSize; 
} 
[** 
* 累计 已 下 载 大 小 
* @param size 
E 
protected synchronized void append(int size) ( 
downloadSize += size; 
} 
[** 
* 更 新 指定 线程 最 后 下 载 的 位 置 
* @param threadId 线程 ID 
* @param pos 最 后 下 载 的 位 置 
ny! 
protected void update(int threadId, int pos) { 
this.data.put (threadId, pos); 
} 
/[** 
* 保存 记录 文件 
a 
protected synchronized void saveLogFile() { 
this.fileService.update(this.downloadUrl, this.data); 
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构建 文件 下 载 器 

@param downloadUrl 下 载 路 径 
eparam fileSaveDir 文件 保存 目录 
eparam threadNum 下 载 线程 数 


»* o» ox o 


eX 
public FileDownloader(Context context, String downloadUrl, File 
fileSaveDir, int threadNum) ( 
try ( 
this.context - context; 
this.downloadUrl = downloadUrl; 
fileService - new FileService (context); 
this.url = new URL (downloadUrl); 
if(!fileSaveDir.exists()) fileSaveDir.mkdirs(); 
this.threads - new DownloadThread[threadNum]; 
HttpURLConnection conn = (HttpURLConnection) url.openConnection () ; 
conn.setConnectTimeout (6*1000) ; 
conn.setRequestMethod ("GET") ; 
conn.setRequestProperty("Accept", "image/gif, image/jpeg, 
image/pjpeg, image/pjpeg, application/x-shockwave-flash, 
application/xaml+xml, application/vnd.ms-xpsdocument, 
application/x-ms-xbap, application/x-ms-application, 
application/vnd.ms-excel, application/vnd.ms-powerpoint, 
application/msword, */*"); 
conn.setRequestProperty ("Accept-Language", "zh-CN"); 
conn.setRequestProperty ("Referer", downloadUrl); 
conn.setRequestProperty("Charset", "UTF-8"); 
conn.setRequestProperty ("User-Agent", "Mozilla/4.0 
(compatible; MSIE 8.0; Windows NT 5.2; Trident/4.0; .NET 
CLR 1.1.4322; .NET CLR 2.0.50727; .NET CLR 3.0.04506.30; .NET 
CLR 3.0.4506.2152; .NET CLR 3.5.30729)"); 
conn.setRequestProperty ("Connection", "Keep-Alive"); 
conn.connect () ; 
printResponseHeader (conn) ; 
if (conn.getResponseCode()--200) ( 
this.fileSize = conn.getContentLength () ;// 根 据 响 应 获取 文件 大 小 
if (this.fileSize «- 0) throw new RuntimeException 


("无 法 获知 文件 大 小 ") ; 


String filename = getFileName (conn); 
this.saveFile = new File(fileSaveDir, filename);/* 保存 文件 */ 
Map<Integer, Integer» logdata = fileService.getData (downloadUrl); 
if (logdata.size()>0) { 
data.putAll (logdata) ; 
} 
this.block = this.fileSize / this.threads.length + 1; 
if (this.data.size()==this.threads.length) { 
for (int i = 0; i < this.threads.length; i++) { 
this.downloadSize += this.data.get(i*1)-(this.block * i); 
} 
print ("已 经 下 载 的 长 度 "+ this.downloadSize); 
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jelse{ 
throw new RuntimeException ("服务 器 响应 错误 ") ; 
} 
} catch (Exception e) { 
print (e.toString()); 
throw new RuntimeException (" 连 接 不 到 下 载 路 径 ") ; 


/[** 
* 获取 文件 名 
22 
private String getFileName (HttpURLConnection conn) ( 
String filename = this.url.toString().substring 
(this.url.toString().lastIndexOf('/') + 1); 
if(filename--null || "".equals(filename.trim()))( 
// 如 果 获取 不 到 文件 名 称 
for (int i = 0;; i++) ( 
String mine - conn.getHeaderField(i); 
if (mine -- null) break; 
if("content-disposition".equals (conn. 
getHeaderFieldKey (i).toLowerCase()))( 
Matcher m = Pattern.compile(".*filename-(.*)"). 
matcher (mine.toLowerCase()); 
if(m.find()) return m.group(1); 
) 
) 
filename = UUID.randomUUID()+ " .tmp";// 默 认 取 一 个 文件 名 
) 
return filename; 
) 
[** 
* FP FAT 
* @param listener 监听 下 载 数量 的 变化 ， 如 果 不 需 要 了 解 实时 下 载 的 数量 ， 可 以 
WU null 
* @return 已 下 载 文件 大 小 
* @throws Exception 
SA 
public int download(DownloadProgressListener listener) throws 
Exception{ 
try { 
if(this.data.size() != this.threads.length) { 
this.data.clear(); 
for (int i = 0; i < this.threads.length; i++) { 
this.data.put(i+l, this.block * i); 


for (int i = 0; i < this.threads.length; i++) { 
int downLength = this.data.get(i+1) - (this.block * i); 
if(downLength < this.block && this.data.get (i+1) 
<this.fileSize) { // 该 线程 未 完成 下 载 时 ， 继 续 下 载 


RandomAccessFile randOut = new RandomAccessFile 
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(this.saveFile, "rw"); 

if(this.fileSize»0) randOut.setLength (this.fileSize); 
randOut .seek (this.data.get (i+1)); 
this.threads[i] = new DownloadThread(this, this.url, 

randOut, this.block, this.data.get(i+1l), i41); 
this.threads[i].setPriority(7); 
this.threads[i].start(); 

}else{ 

this.threads[i] = null; 


this.fileService.save(this.downloadUrl, this.data); 
boolean notFinish = true;// 下 载 未 完成 
while (notFinish) (// 循环 判断 是 否 下 载 完 毕 
Thread.sleep (900); 
notFinish = false;// 假 定 下 载 完成 
for (int i = 0; i < this.threads.length; i++) { 
if (this.threads[i] != null && !this.threads[i] 
isFinish()) { 
notFinish = true;// 下 载 没 有 完成 
if(this.threads[i].getDownLength() == -1)( 
// 如 果 下 载 失败 ， 再 重新 下 载 
RandomAccessFile randOut = new RandomAccessFile 
(this.saveFile, "rw"); 
randOut.seek(this.data.get(i*1)); 


this.threads[i] - new DownloadThread(this, this.url, 
randOut, this.block, this.data.get(i+1), i+1); 

this.threads[i].setPriority(7); 

this.threads[i].start(); 

) 


b 
if(listener!-null) listener.onDownloadSize (this.downloadSize); 
} 
fileService.delete (this.downloadUrl); 
) catch (Exception e) ( 
print (e.toString()); 
throw new Exception ("下 载 失败 "); 
} 
return this.downloadSize; 
} 
y. ** 
* 获取 HTTP 响应 头 字段 
* @param http 
* @return 
ff 
public static Map<String, String> getHttpResponseHeader 
(HttpURLConnection http) { 
Map<String, String> header = new LinkedHashMap<String, String>(); 
for (int i = 0;; i++) { 
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String mine = http.getHeaderField(i); 
if (mine == null) break; 
header.put(http.getHeaderFieldKey(i), mine); 
} 
return header; 
} 
/ ** 
* 打印 HTTP 头 字段 
* @param http 
Fo) 
public static void printResponseHeader (HttpURLConnection http) { 
Map<String, String> header = getHttpResponseHeader (http) ; 
for (Map.Entry<String, String» entry : header.entrySet ()) { 
String key = entry.getKey() !=null ? entry.getKey()+ ":" : ""; 
print (key+ entry.getValue()); 
} 
} 
private static void print (String msg) { 
Log.i(TAG, msg); 


} 


(7) 编写 文件 DownloadProgressListener.java， 具 体 代 码 如 下 : 


package com.changcheng.net.download; 

public interface DownloadProgressListener { 
public void onDownloadSize(int size); 

) 


(8) 编写 文件 FileService.java， 具 体 代 码 如 下 : 


package com.changcheng.download.service; 
import java.util.HashMap; 
import java.util.Map; 
import android.content.Context; 
import android.database.Cursor; 
import android.database.sqlite.SQLiteDatabase; 
[** 
* 业务 bean 
* 
zy 
public class FileService { 
private DBOpenHelper openHelper; 
public FileService (Context context) { 
openHelper = new DBOpenHelper (context); 
b 
/[** 
* 获取 线程 最 后 下 载 位 置 
* (param path 
* @return 
xp 
public Map«Integer, Integer» getData(String path) { 
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SQLiteDatabase db = openHelper.getReadableDatabase(); 
Cursor cursor = db.rawQuery("select threadid, position 
from filedown where downpath=?", new String[]{path}); 
Map«Integer, Integer» data = new HashMap<Integer, Integer>(); 
while (cursor.moveToNext ())( 
data.put(cursor.getInt(0), cursor.getInt(1)); 
} 
cursor.close(); 
db.close(); 
return data; 
} 
[** 
* 保存 下 载 线程 初始 位 置 
* @param path 
* (param map 
E 
public void save(String path, Map<Integer, Integer» map) {//int 
threadid, int position 
SQLiteDatabase db - openHelper.getWritableDatabase(); 
db.beginTransaction(); 
tryt 
for (Map.Entry<Integer, Integer» entry : map.entrySet()) { 
db.execSQL("insert into filedown(downpath, threadid, 
position) values(?,?,2)", 
new Object[]{path, entry.getKey(), entry.getValue()]); 


db.setTransactionSuccessful (); 
}finally{ 
db.endTransaction (); 
} 
db.close(); 
} 
[** 
* 实时 更 新 线程 的 最 后 下 载 位 置 
* @param path 
* @param map 
Ud 
public void update(String path, Map<Integer, Integer» map) { 
SQLiteDatabase db = openHelper.getWritableDatabase(); 
db.beginTransaction(); 
try{ 
for (Map.Entry<Integer, Integer» entry : map.entrySet()){ 
db.execSQL("update filedown set position=? where downpath=? 
and threadid=?", 
new Object[]{entry.getValue(), path, entry.getKey()}); 
} 
db.setTransactionSuccessful (); 
}finally{ 
db.endTransaction(); 


db.close(); 
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/** 
* 当 文件 下 载 完成 后 ， 清 空 该 文件 对 应 的 下 载 记 录 
* @param path 
PX 
public void delete(String path) { 
SQLiteDatabase db = openHelper.getWritableDatabase(); 
db.execSQL ("delete from filedown where downpath=?", new 
Object [] {path}) ; 
db.close(); 


} 
(9) 编写 文件 DownloadThreadjava， 具 体 代码 如 下 : 


package com.changcheng.net.download; 
import java.io.InputStream; 
import java.io.RandomAccessFile; 
import java.net.HttpURLConnection; 
import java.net.URL; 
import android.util.Log; 
public class DownloadThread extends Thread ( 
private static final String TAG - "DownloadThread"; 
private RandomAccessFile saveFile; 
private URL downUrl; 
private int block; 
/* 下 载 开 始 位 置 */ 
private int threadId = -1; 
private int startPos; 
private int downLength; 
private boolean finish - false; 
private FileDownloader downloader; 
public DownloadThread(FileDownloader downloader, URL downUrl, 
RandomAccessFile saveFile, int block, int startPos, int threadId) ( 
this.downUrl - downUrl; 
this.saveFile - saveFile; 
this.block = block; 
this.startPos = startPos; 
this.downloader = downloader; 
this.threadId - threadId; 
this.downLength = startPos - (block * (threadld - 1)); 
} 
GOverride 
public void run() ( 
if(downLength < block) {// 未 下 载 完 成 
try { 
HttpURLConnection http = (HttpURLConnection) 
downUrl.openConnection(); 
http.setRequestMethod ("GET") ; 
http.setRequestProperty("Accept", "image/gif, image/jpeg, 
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image/pjpeg, image/pjpeg, application/x-shockwave- 
flash, application/xaml+xml, application/vnd.ms- 
xpsdocument, application/x-ms-xbap, application/ 
x-ms-application, application/vnd.ms-excel, application/ 
vnd.ms-powerpoint, application/msword, */*"); 
http.setRequestProperty ("Accept-Language", "zh-CN"); 
http.setRequestProperty ("Referer", downUrl.toString()); 
http.setRequestProperty ("Charset", "UTF-8"); 


http.setRequestProperty("Range", "bytes=" + 
Ehis-startPos + ="); 

http.setRequestProperty ("User-Agent", "Mozilla/4.0 
(compatible; MSIE 8.0; Windows NT 5.2; Trident/4.0; 
-NET CLR 1.1.4322; .NET CLR 2.0.50727; .NET CLR 
3.0.04506.30; .NET CLR 3.0.4506.2152; .NET CLR 
3E52300729) ym 

http.setRequestProperty "Connection", "Keep-Alive"); 

InputStream inStream = http.getInputStream(); 

int max = block>1024 ? 1024 : (block>10 ? 10 : 1); 

byte[] buffer - new byte[max]; 

int offset = 0; 

print ("线程 " + this.threadId + "从 位 置 "+ this.startPos+ 
"开始 下 载 1); 


while (downLength < block && (offset = inStream.read 
(buffer, 0, max)) != -1) ( 
saveFile.write(buffer, 0, offset); 
downLength += offset; 
downloader.update(this.threadId, block * (threadId - 1) 
* downLength); 
downloader.saveLogFile(); 
downloader.append (offset); 
int spare = block-downLength;// 求 剩 下 的 字 节 数 
if(spare < max) max = (int) spare; 
} 
saveFile.close(); 
inStream.close(); 
print ("线程 ”+ this.threadId + "完成 下 载 ") ; 
this.finish = true; 
this.interrupt (); 
} catch (Exception e) { 
this.downLength = -1; 
print ("线程 "+ this.threadId+ ":"+ e); 
} 


H 
private static void print(String msg) { 
Log.i(TAG, msg); 
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* @return 
= 
public boolean isFinish() { 
return finish; 
} 
/[** 
* 已 经 下 载 的 内 容 大 小 
* @return 如 果 返 回 值 为 -1， 代 表 下 载 失败 
m 
public long getDownLength() ( 
return downLength; 


5 
(10) 编写 文件 DBOpenHelperjava， 具 体 代 码 如 下 : 


package com.changcheng.download.service; 

import android.content.Context; 

import android.database.sqlite.SQLiteDatabase; 

import android.database.sqlite.SQLiteOpenHelper; 

public class DBOpenHelper extends SQLiteOpenHelper ( 
private static final String DBNAME - "download.db"; 
private static final int VERSION - 2; 
public DBOpenHelper(Context context) ( 

super(context, DBNAME, null, VERSION); 


Goverride 
public void onCreate(SQLiteDatabase db) ( 
db.execSQL("CREATE TABLE IF NOT EXISTS filedown (id integer 
primary key autoincrement, downpath varchar(100), threadid 
INTEGER, position INTEGER)"); 
} 
@override 
public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) { 
db.execSQL("DROP TABLE IF EXISTS filedown"); 
onCreate (db) ; 


15.4 判断 当前 网 络 GPRS 和 Wi-Fi 的 状态 


在 Android 开发 过 程 中 ， 特 别 是 在 开发 和 网 络 相 关 的 一 些 应 用 时 ， 很 可 能 会 用 到 网 络 
连接 状态 ， 包 括 GPRS. Wi-Fi 等 。 其 实 解 决 这 些 问 题 的 方法 很 简单 ，Android 提供 了 两 个 


类 ， 一 个 是 ConnectivityManager， 另 一 个 是 NetworkImfo。 通 过 这 两 个 类 即 可 判断 当前 网 络 
GPRS 和 Wi-Fi 的 状态 。 
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15.4.1 ConnectivityManager 类 和 Networklnfo 类 


在 Android 开发 过 程 中 ， 通 过 类 ConnectivityManager 可 以 实现 管理 和 网 络 连接 相关 的 
操作 ， 例 如 相关 的 TelephonyManager 可 以 管理 和 手机 、 运 营 商 等 的 相关 信息 ， 而 
WifiManager 则 管理 和 Wi-Fi 相关 的 信息 。 

要 想 访 问 网 络 状态 ， 首 先 得 添加 如 下 权限 : 


«uses-permission 
android:name-"android.permission.ACCESS NETWORK STATE"/» 


类 NetworkInfo 包含 了 对 Wi-Fi 和 Mobile 两 种 网 络 模式 连接 的 详细 描述 ， 通 过 
getState() 方 法 获取 的 State 对 象 则 代表 着 连接 成 功 与 否 等 状态 。 
例如 下 面 的 代码 演示 了 这 两 个 类 的 基本 用 法 。 


y 
public void testConnectivityManager() { 

ConnectivityManager connManager = (ConnectivityManager) this 
.getSystemService (CONNECTIVITY SERVICE); 

// 获取 代表 联网 状态 的 NetWorkInfo 对 象 

NetworkInfo networkInfo = connManager.getActiveNetworkInfo(); 

// 获取 当前 的 网 络 连 接 是 否 可 用 

boolean available = networkInfo.isAvailable(); 

if (available) { 

Log.i("üAn", "HiT 2 HE Be BY AY") ; 

} 

else{ 

Log.i("3üAn", "HT Ie EBERT RI") ; 

) 

State state = connManager.getNetworkInfo (ConnectivityManager. 
TYPE MOBILE).getState(); 

if (State.CONNECTED==state) ( 

Log.i (" 通 知 "， "GPRS 网 络 已 连接 ") ; 

) 

state = 

connManager .getNetworkInfo (ConnectivityManager .TYPE WIFI) .getState(); 
if (State.CONNECTED==state) { 
Log.i (" 通 知 "， "WIFI 网 络 已 连接 ") ; 


) 
// 跳 转 到 无 线 网 络 设置 界面 
startActivity (new 
Intent (android.provider.Settings.ACTION WIRELESS SETTINGS)); 
// 跳 转 到 无 线 Wi-Fi 网 络 设置 界面 
startActivity(new Intent(android.provider.Settings.ACTION WIFI SETTINGS)); 


5 

了 解 了 类 ConnectivityManager 和 类 NetworkInfo 的 基本 用 法 后 ， 判 断 当 前 网 络 GPRS 
和 Wi-Fi 状态 的 问题 就 迎刃而解 了 。 例 如 通过 下 面 的 代码 就 可 以 实现 。 

import android.content.Context; 

import android.net.ConnectivityManager; 
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import android.net.NetworkInfo; 
public class Test extends Activity ( 
private ConnectivityManager cm; 
private NetworkInfo info; 
/** Called when the activity is first created. */ 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 
cm = (ConnectivityManager) getSystemService 
(Context.CONNECTIVITY SERVICE) ; 
if (cm.getNetworkInfo(1).getState() == NetworkInfo.State.CONNECTED) 
{ 
text.setText ("WIFI DAK"); 
t 
else { 
text.setText ("WIFI 未 连接 ") ; 
} 
if (cm.getNetworkInfo(0).getState() == NetworkInfo.State.CONNECTED) 
t 


text.setText ("GPRS 已 经 连接 ") ; 
) 
else ( 

text.setText ("GPRS AER") ; 


} 
d 


通过 下 面 的 代码 可 以 判断 是 否 有 网 络 连接 。 
public boolean isNetworkConnected(Context context) ( 
if (context !- null) ( 
ConnectivityManager mConnectivityManager = (ConnectivityManager) 
context 
.getSystemService(Context.CONNECTIVITY SERVICE); 
NetworkInfo mNetworkInfo — 


mConnectivityManager.getActiveNetworkInfo(); 
if (mNetworkInfo != null) { 
return mNetworkInfo.isAvailable(); 


} 
return false; 
} 


通过 下 面 的 代码 可 以 判断 Wi-Fi 网 络 是 否 可 用 。 
public boolean isWifiConnected(Context context) { 
if (context != null) ( 
ConnectivityManager mConnectivityManager = (ConnectivityManager) 
context.getSystemService (Context.CONNECTIVITY SERVICE); 


NetworkInfo mWiFiNetworkInfo = mConnectivityManager 
-getNetworkInfo (ConnectivityManager.TYPE WIFI); 
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if (mWiFiNetworkInfo != null) { 
return mWiFiNetworkInfo.isAvailable(); 


} 
return false; 


通过 下 面 的 代码 可 以 判断 Mobile 网 络 是 否 可 用 。 


public boolean isMobileConnected(Context context) ( 
if (context !- null) ( 

ConnectivityManager mConnectivityManager - (ConnectivityManager) 
context.getSystemService (Context.CONNECTIVITY SERVICE); 

NetworkInfo mMobileNetworkInfo = mConnectivityManager 

-getNetworkInfo (ConnectivityManager.TYPE MOBILE); 

if (mMobileNetworkInfo != null) { 

return mMobileNetworkInfo.isAvailable(); 


} 
return false; 
} 


通过 下 面 的 代码 可 以 获取 当前 网 络 连接 的 类 型 信息 。 
public static int getConnectedType (Context context) { 


if (context !- null) ( 


ConnectivityManager mConnectivityManager - (ConnectivityManager) 
context.getSystemService (Context.CONNECTIVITY SERVICE); 
NetworkInfo mNetworkInfo — 


mConnectivityManager.getActiveNetworkInfo(); 
if (mNetworkInfo !- null && mNetworkInfo.isAvailable()) ( 
return mNetworkInfo.getType(); 


H 
return -1; 


15.4.2 ”在 程序 启动 时 对 网 络 状态 进行 判断 


在 使 用 Android 连接 网 络 的 时 候 ， 并 不 是 每 次 都 能 连接 到 网 络 ， 这 时 最 好 在 程序 启动 
时 对 网 络 的 状态 进行 判断 ， 如 果 没 有 网 络 则 即时 提醒 用 户 进行 设置 。 要 判断 网 络 状态 ， 首 
先 需 要 有 相应 的 权限 。 下 面 为 允许 访问 网 络 状态 权限 的 代码 : 


«uses-permission android:name-"android.permission.ACCESS NETWORK STATE"> 
«/uses-permission» 


下 面 为 具体 的 判断 代码 : 


private boolean NetWorkStatus() ( 
boolean netSataus = false; 


ConnectivityManager cwjManager = (ConnectivityManager) 
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getSystemService (Context.CONNECTIVITY SERVICE); 
cwjManager.getActiveNetworkInfo(); 
if (cwjManager.getActiveNetworkInfo() != null) { 
netSataus = cwjManager.getActiveNetworkInfo().isAvailable(); 
} 
if (netSataus) { 
Builder b = new AlertDialog.Builder (this) .setTitle (" 没 有 可 用 
的 网 络 ") 
.setMessage (" 是 否 对 网 络 进行 设置 ? n) ; 
b.setPositiveButton (" 是 "，new DialogInterface. 
OnClickListener() ( 
public void onClick(DialogInterface dialog, int whichButton) ( 

Intent mIntent = new Intent ("/"); 

ComponentName comp = new ComponentName ( 
"com.android.settings", 
"com.android.settings.WirelessSettings"); 

mIntent.setComponent (comp) ; 

mIntent.setAction ("android.intent.action.VIEW") ; 

// 如 果 在 设置 完成 后 需要 再 次 进行 操作 ， 可 以 重 写 操作 代码 ， 在 这 里 不 再 重 写 

startActivityForResult (mIntent, 0); 

) 
}) .setNeutralButton ("#i", new DialogInterface.OnClickListener() ( 
public void onClick(DialogInterface dialog, int whichButton) ( 
dialog.cancel(); 
) 
}) .show(); 
} 
return netSataus; 


15.5 ”开启 或 关闭 APN 


虽然 Android 对 于 APN 的 网 络 API 没有 公开 ,但 是 我 们 可 以 参考 源 代码 ， 然 后 进行 
数据 库 操 作 ， 这 样 系统 会 自动 监听 数据 库 的 变化 ， 从 而 实现 开启 或 者 关闭 APN 的 操作 。 读 
者 在 获取 Android 的 源 代码 后 ， 可 以 重点 研究 一 下 文件 frameworks/base/core/Java/android/ 
provider/Telephony java 中 的 类 。 此 类 的 核心 是 URI 和 数据 库 字 段 content://telephony/carriers, 
该 字段 可 以 在 文件 Telephony.java 中 找到 。 

下 面 的 演示 代码 实现 了 如 下 两 个 功能 。 

(1) 当 开 启 APN 的 时 候 ， 设 置 一 个 正确 的 移动 或 者 联通 的 APN. 

(2) 关闭 的 时 候 设置 一 个 错误 的 APN 就 会 自动 关闭 网 络 。 

首先 定义 继承 于 Activity 的 类 Main， 代 码 如 下 : 

package cc.mdev.Demo; 


import java.util.ArrayList; 
import java.util.List; 


Andicid 54555253 


import android.app.Activity; 

import android.content.ContentValues; 
import android.database.Cursor; 
import android.net.Uri; 

import android.os.Bundle; 

import android.util.Log; 

import android.view.View; 

import android.widget.Button; 

/** 


* Activity 

* (author SinFrancis wong 

ay 

public class Main extends Activity { 

/** Called when the activity is first created. */ 
Uri uri = Uri.parse("content://telephony/carriers"); 
@override 

public void onCreate(Bundle savedInstanceState) { 
super .onCreate (savedInstanceState) ; 

setContentView (R.layout.main) ; 

Button open= (Button) findViewById(R.id.open) ; 
Button close- (Button) findViewById(R.id.close) ; 
open.setOnClickListener (new View.OnClickListener() { 
@override 

public void onClick(View v) { 

openAPN () ; 

} 

}); 

close.setOnClickListener(new View.OnClickListener() ( 
GOverride 

public void onClick(View v) ( 


closeAPN (); 

} 

n; 

) 

public void openAPN() { 

List list = getAPNList(); 

for (APN apn : list) { 

ContentValues cv - new ContentValues(); 

cv.put("apn", APNMatchTools.matchAPN (apn.apn)); 

cv.put("type", APNMatchTools.matchAPN (apn.type)); 
getContentResolver().update(uri, cv, " id-?", new String[]{apn.id}); 
) 

} 

public void closeAPN() { 

List list = getAPNList(); 

for (APN apn : list) { 

ContentValues cv = new ContentValues(); 

cv.put("apn", APNMatchTools.matchAPN (apn.apn) *"mdev") ; 
cv.put("type", APNMatchTools.matchAPN (apn.type) +"mdev") ; 
getContentResolver().update(uri, cv, " id-?", new String[](apn.id]); 
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} 

private List getAPNList (){ 

String tag = "Main.getAPNList ()"; 

//current 不 为 空 表示 可 以 使 用 的 A PN 

String projection[] = (" id,apn,type,current"]; 

Cursor cr - this.getContentResolver().query(uri, projection, null, 

null, null); 

List list - new ArrayList(); 

while(cr!-null && cr.moveToNext ()) { 

Log.d(tag, cr.getString(cr.getColumnIndex(" id")) +" "+ 
cr.getString(cr.getColumnIndex("apn"))  " "+ 
cr.getString(cr.getColumnIndex("type"))+ " " + 
cr.getString (cr.getColumnIndex ("current") )); 

APN a = new APN(); 

a.id = cr.getString(cr.getColumnIndex(" id")); 

a.apn = cr.getString(cr.getColumnIndex ("apn") ); 

a.type = cr.getString(cr.getColumnIndex ("type") ) 7 

list.add (a); 

} 

if (cr!=null) 

cr.close(); 

return list; 

} 

public static class APN{ 

String id; 

String apn; 

String type; 

} 

} 


然后 实现 不 同 运营 商 的 APN， 演 示 代 码 如 下 : 


package cc.mdev.apn; 

public final class APNMatchTools ( 
public static class APNNet( 

/* 

* 中 国 移动 cmwap 

E 

public static String CMWAP = "cmwap"; 
[** 

* 中 国 移动 cmnet 

v 

public static String CMNET - "cmnet"; 


// 中 国联 通 3cwap 设置 中 国联 通 3c 因特网 设置 中 国联 通 WAP 设置 中 国联 通 因特网 设置 
//3gwap 3gnet uniwap uninet 

[** 

* 3G wap 中 国联 通 3gwap APN 

“aif 

public static String GWAP 3 = "3gwap"; 


> Andid sssan^nsmia 


[** 

* 3G net 中 国联 通 3gnet APN 

xz 

public static String GNET 3-"3gnet"; 
[** 

* uni wap 中 国联 通 uni wap APN 

eur 

public static String UNIWAP-"uniwap"; 
/** 

* uni net 中 国联 通 uni net APN 

eu 


public static String UNINET-"uninet"; 
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public static String matchAPN(String currentName) ( 
if("".equals(currentName) || null==currentName) { 
return " 
) 
currentName - currentName.toLowerCase(); 

if(currentName.startsWith (APNNet . CMNET) ) 

return APNNet.CMNET; 

else if(currentName.startsWith (APNNet . CMWAP) ) 

return APNNet.CMWAP; 

else if(currentName.startsWith (APNNet.GNET 3)) 

return APNNet.GNET 3; 

else if(currentName.startsWith (APNNet.GWAP 3)) 

return APNNet.GWAP 3; 

else if(currentName.startsWith (APNNet . UNINET) ) 

return APNNet.UNINET; 

else if(currentName.startsWith (APNNet . UNIWAP) ) 

return APNNet .UNIWAP; 

else if (currentName.startsWith ("default") ) 

return "default"; 

else return ""; 

// return currentName.substring(0, currentName.length() - SUFFIX.length()); 
} 

k 


Ue ies 
开发 一 个 邮件 系统 


现代 社会 科技 发 展 迅速 ， 移 动 设备 在 我 们 生活 中 应 用 广 
泛 ， 主 要 用 于 娱乐 、 办 公 、 科 研 等 多 个 领域 。 基 于 移动 设备 上 
的 应 用 系统 发 展 也 相当 迅速 ， 同 时 移动 设备 运用 领域 的 扩大 也 
提高 了 对 系统 的 要 求 。Android 作为 一 个 开源 系统 ， 为 移动 设 
备 市 场 的 发 展 提供 了 机 遇 。 本 章 的 邮件 系统 实例 采用 Android 
开源 系统 技术 ， 利 用 Java 语言 和 Eclipse 开发 工具 对 邮件 系统 
进行 开发 ， 同 时 给 出 详细 的 系统 设计 流程 、 部 分 界面 图 及 主要 
功能 效果 流程 图 。 在 本 章 的 内 容 中 ， 还 对 开发 过 程 中 遇 到 的 问 
题 和 解决 方法 进行 详细 的 讨论 。 邮 件 系统 实例 集 用 户 设置 、 邮 
件 收 取 和 邮件 发 送 等 功能 于 一 体 ， 在 Android 系统 中 能 独立 运行 。 


e Android sax nsma 
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本 章 邮件 系统 源码 保存 在 本 书 附 带 光盘 中 的 “光盘 :vdaima\16” 目 录 下 。 在 讲解 具体 编 
码 之 前 ， 先 简要 介绍 本 项 目的 产生 背景 和 项 目 意义 ， 为 后 面 的 系统 设计 及 编码 做 准备 。 


16.1.1 项 目 背 景 


随 着 科学 技术 的 发 展 ， 计 算 机 进入 了 生活 ， 娱 乐 和 办 公 。 在 计算 机 系统 中 ， 使 用 邮件 
系统 收发 邮件 是 工作 中 必 不 可 少 的 组 成 部 分 ， 如 今 社会 竞争 十 分 激烈 ， 工 作 效 率 显得 越发 
重要 。 使 用 手机 或 者 是 便捷 设备 在 旅行 、 出 差 或 者 是 路 上 处 理工 作 事务 和 朋友 间 的 联系 越 
来 越 流行 。 因 此 ， 人 们 的 生活 越 来 越 离 不 开 手 机 的 陪伴 。 随 着 手机 硬件 和 软件 系统 的 发 
展 ， 人 们 对 移动 电子 设备 的 硬件 性 能 和 软件 性 能 要 求 也 越 来 越 高 。 

全 球 最 大 的 移动 设备 手机 发 展 十 分 迅速 ， 同 时 手机 操作 系统 也 出 现 了 不 同 种 类 ， 目 前 
市 场 上 主要 有 三 种 手机 操作 系统 : 微软 的 Windows Phone、 苹 果 的 ISO 和 Google 的 
Android 操作 系统 ， 其 中 只 有 Android 开放 源 代 码 。 全 球 针 对 Android 平台 开发 的 团体 和 个 
人 数量 庞大 ， 因 此 Android 系统 得 以 飞速 发 展 。 既 然 手 机 如 此 智能 ， 我 们 通过 手机 接收 邮 
件 可 以 实现 吗 ? 答案 是 肯定 的 ! 谷歌 的 Android 系统 可 以 满足 你 的 要 求 。 本 章 讲解 的 邮件 
系统 实例 就 是 基于 谷歌 的 Android 手机 平台 开发 的 。 

开发 一 个 邮件 系统 ， 要 了 解 邮件 系统 支持 的 通信 协议 ， 以 及 各 协议 之 间 存 在 哪些 差 
异 ， 还 要 对 开发 平台 有 较 深 入 的 了 解 ， 分 析 现在 流行 的 邮件 系统 中 的 优点 、 缺 点 和 用 户 最 
常用 的 功能 。 


16.1.2 MAAR 


目前 社会 竞争 激烈 ， 提 高 工作 效率 越 来 越 重要 ， 而 互联 网 办 公 是 其 中 最 好 的 提高 工作 
效率 的 方式 之 一 。 本 项 目的 目的 是 开发 一 个 在 手机 或 者 是 移动 设备 上 使 用 的 邮件 系统 ， 该 
系统 的 主要 功能 是 邮箱 类 型 设 定 、 邮 件 收 取 设 置 、 邮 件 发 送 设置 、 用 户 检查 、 用 户 别名 设 
置 和 编辑 邮件 ， 支 持 POP3 和 IMAP 通信 协议 ， 检 查 用 户 的 设 定 是 否 正 确 。 系 统 界 面 简 
明 ， 操 作 简单 。 

本 项 目 是 基于 Android 手机 平台 的 邮件 系统 ， 让 Android 手机 拥有 个 性 的 邮件 系统 ， 
使 手机 显得 更 方便 和 智能 ， 与 人 们 更 为 亲近 ， 手 机 主人 可 以 随时 随地 处 理工 作 事务 或 者 是 
与 朋友 联系 ， 使 人 们 的 生活 更 加 多 样 化 ， 也 使 设计 者 更 加 熟练 Android 的 技术 和 其 他 在 市 
场 上 的 特点 。 


根据 项 目的 目标 ， 
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16.2 系统 需求 分 析 


我 们 可 分 析出 系统 的 基本 需求 。 以 下 从 软件 设计 的 角度 来 描述 系统 


的 功能 ， 并 且 使 用 例 图 来 描述 系统 的 功能 模块 ， 大 致 分 成 五 部 分 来 概括 ， 即 邮箱 类 型 设 
置 、 邮 箱 收取 设置 、 邮 箱 发 送 设置 、 邮 箱 用 户 检查 和 用 户 邮件 编辑 。 


16.2.1 构成 模块 
邮件 系统 的 构成 模块 如 图 16-1 所 示 。 


m 
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图 16-1 邮件 系统 构成 模块 


邮件 系统 各 个 模块 的 具体 说 明 如 下 。 


1. 邮箱 类 型 设置 


此 模块 的 功能 是 设置 通信 协议 。 


1) POP3 协议 


a 目标: 使 得 用 户 可 以 收发 邮件 到 本 地 。 
a WHAT: 成 功 登 录 邮 件 系统 。 


Q ”基本 事件 流 : 


+ ”用 户 单 击 Next 按钮 。 
4 ”程序 进入 邮箱 收取 设置 。 


2) IMAP 协议 


a ”目标 : 使 得 用 户 可 以 在 线 收发 邮件 。 
a WHAT: 成 功 登 录 邮 件 系统 。 


o “基本 事件 流 : 
e ried 


F Next 按钮 。 


e ”程序 进入 邮箱 收取 设置 。 
邮箱 类 型 设置 界面 结构 如 图 16-2 所 示 。 
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通信 协议 
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16-2 ”邮箱 类 型 设置 界面 结构 


2. 邮箱 收取 设置 
当 用 户 选 定 通信 协议 后 ， 可 以 进行 邮箱 收取 功能 的 设置 。 


a Hb: 


设 定 用户 基 本 信息 。 


a ”前 置 条 件 : 程序 运行 在 用 户 基本 信息 设 定 界面 。 
a ”基本 事件 流 : 


+++ + o 


用 户 填 写 用 户 名 和 密码 。 
用 户 填 写 服务 器 名 和 端口 。 
用 户 填 写 加 密 协 议 。 

用 户 设 定 邮件 删除 期 限 。 
用 户 单 击 Next 按钮 。 


邮箱 收取 设置 界面 结构 如 图 16-3 所 示 。 


邮箱 收取 设置 


填写 
用 户 | | 服务 
名 和 | | 器 信 

息 
密码 


16-3 ”邮箱 收取 设置 界面 结构 


3. 邮箱 发 送 设置 


本 模块 用 了 
Q Hb: 


FF 设置 邮箱 发 送 。 
设 定 邮箱 发 送 。 


O MRZI: 程序 运行 在 邮箱 发 送 设 定 界 面 。 


a ”基本 事件 流 : 


e 用户 填写 服务 器 名 和 端口 。 
+ JAP Sai Next 按钮 。 


邮箱 发 送 设置 界 1 


H 


4. 邮箱 用 户 检查 


结构 如 图 16-4 所 示 。 


邮箱 发 送 设置 
i i 

服务 

加 密 | | 服务 

协议 | | AEF 
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图 16-4 邮箱 发 送 设置 界面 结构 


此 模块 的 功能 是 邮箱 用 户 检查 。 
1) 用 户 名 和 密码 验证 


a ”目标 : 验证 用 户 名 和 密码 的 正确 性 。 


a WHAT: 程序 运行 在 主 界面 。 
o ”基本 事件 流 。 


2) 接收 地 址 验证 


a Abs: 验证 接收 地 址 的 正确 性 。 
Q ”前 置 条 件 : 程序 运行 在 目录 界面 。 
a ”基本 事件 流 。 


3) 发 送 地 址 验证 


a ”目标 : 验证 发 送 地 址 的 正确 性 。 


OQ ”前 置 条 件 ， 程序 运行 在 目录 界面 。 


Q ”基本 事件 流 : 用 户 单 击 Next 按钮 。 
邮箱 用 户 检查 界面 结构 如 图 16-5 所 示 。 


5. 用 户 邮 件 编辑 


此 模块 的 功能 是 用 户 邮件 编辑 。 
a 目标 : 编辑 邮件 。 
O ”前 置 条 件 ， 进入 邮件 编辑 界面 。 


o ”基本 事件 流 : 


”用户 填写 收 件 人 地 址 。 
e ”用 户 填 写 标题 。 
”用户 填写 邮件 内 容 。 


e Andioid s5z5^nsma 


e JAP Éh Send 按钮 。 
用 户 邮 件 编辑 界面 结构 如 图 16-6 所 示 。 


邮箱 用 户 检查 


i i l 


用 户 名 和 发 送 服务 | | 接收 服务 
密码 器 设置 器 设置 


图 16-5 邮箱 用 户 检查 界面 结构 


邮件 编辑 
1 Ld 


BUFA | | 邮件 标 | | 邮件 内 
题 容 


16-6 ”邮件 编辑 界面 结构 
16.2.2 ”系统 流程 
邮件 系统 流程 如 图 16-7 所 示 。 


邮箱 发 送 设 置 
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Y 
返回 iai >~ 
ae 


y 
图 16-7 邮件 系统 流程 图 
16.2.3 ”功能 结构 图 
邮件 系统 的 完整 功能 结构 如 图 16-8 所 示 。 
邮件 系统 
Il J J Ji Ji 
用 户 登录 LEM MARE ay iren 
L do de L Loot Cee LLLI 
36 || 4e || à PO || IM | | | 给 输 || 给 输 || 输 | | 给 || 确 
入 || 入 || 定 P3 || AP 入 || 入 || 入 AJA 入 || 入 | | 入 || 定 
LUE be || b» 密 || 服 || 服 IR || e || | | 邮 
Pm 议 || 议 || 码 || 务 || 务 务 || 务 || 件 || 件 | | 件 
名 器 | | 器 LAE 人 || 标 | | 内 
tej |x EIEAIE 地 || 题 | | 容 
hin hn ht 


16-8 邮件 系统 完整 功能 结构 图 


16.24 系统 功能 说 明 
邮件 系统 各 个 模块 功能 的 说 明 如 表 16-1 所 示 。 
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表 16-1 ”模块 结构 功能 说 明 信 息 


功能 类 别 子 功 能 
输入 用 户 名 
用 户 登录 输入 密码 
进入 邮件 登录 设置 
POP3 协议 
IMAP 协议 


邮箱 类 型 设置 


邮箱 用 户 检查 模块 


输入 用 户 名 
输入 密码 

邮箱 收取 设置 输入 服务 器 地 址 
输入 服务 器 端口 
输入 加 密 协议 
输入 服务 器 地 址 

邮箱 发 送 设置 输入 服务 器 端口 
输入 加 密 协 议 
输入 收 件 人 地 址 
输入 邮件 标题 
输入 邮件 内 容 
单 击 “ 发 送 ” 按 钮 


用 户 邮件 编辑 


16.25 ”系统 需求 


1. 系统 性 能 需 3 

根据 Android 手机 系统 要 求 无 响应 时 间 为 5 秒 ， 所 以 就 有 以 下 性 能 要 求 。 
Bp 箱 类 型 设置 ， 程 序 响 应 时 间 最 长 不 能 超过 5 秒 。 
Bp 箱 收 取 设 置 ， 程 序 响 应 时 间 最 长 不 能 超过 5 秒 。 
Bp 箱 发 送 设置 ， 程 序 响 应 时 间 最 长 不 能 超过 5 秒 。 
B 箱 用 户 检 查 ， 程 序 响 应 时 间 最 长 不 能 超过 5 秒 。 
用 户 邮 件 编辑 ， 程 序 响 应 时 间 最 长 不 能 超过 5 秒 。 
运行 环境 需求 

操作 系统 : Android 手机 基于 Linux 操作 系统 。 
支持 环境 : Android 1.5 - 2.0.1 版 本 。 

发 环境 : Eclipse 3.5 ADT 0.95. 


ooo » ooooo 
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16.3 数据 存储 设计 


基于 Windows 或 者 是 Linux 的 大 型 系统 开发 ， 数 据 库 使 用 的 都 是 专业 数据 库 系 统 ， 
Android 开发 平台 提供 了 几 种 数据 存储 : Android 系统 中 自 带 的 iSQLite 数据 库 、 数 据 接口 共 
享 数据 (SharedPreferences) 模 式 保存 数据 、 文 件 方式 保存 数据 、 内 容 提供 器 (ContextproviderD) 
和 网 络 方式 保存 数据 。 数 据 库 是 存放 数据 的 仓库 ， 只 不 过 这 个 仓库 是 在 计算 机 存储 设备 
上 ， 而 且 数 据 是 按 一 定 的 格式 存放 的 。 本 实例 采用 SharedPreferences 保存 数据 。 
SharedPreferences 是 以 XML 格式 文件 的 方式 自动 保存 ， 在 DDMS 的 File Exploer 下 展 
开 /data/data/<package name>/shared_prefs， 生 成 AndroidMail.Main.xml 文件 。 


16.3.1 用 户 信息 类 


定义 用 户 信 息 Accountjava 类 ， 此 类 将 保存 系统 用 户 有 关 的 所 有 信息 。 为 
SharedPreferences 模式 保存 数据 提供 用 户 实例 对 象 。 对 应 代码 如 下 : 


public class Account implements Serializable { 
public static final int DELETE POLICY NEVER = 0; 
public static final int DELETE POLICY 7DAYS = 1; 
public static final int DELETE POLICY ON DELETE = 2; 

private static final long serialVersionUID = 2975156672298625121L; 


String mUuid; // 邮 件 用 户 ID 
String mStoreUri; / LAT DH HE 
String mLocalStoreUri; 

String mSenderUri; // 邮 件 目的 地 址 
String mDescription; // 邮 件 内 容 
String mName; // 用 户 名 


String mEmail; 

int mAutomaticCheckIntervalMinutes; 

long mLastAutomaticCheckTime; 

boolean mNotifyNewMail; 

String mDraftsFolderName; 

String mSentFolderName; 

String mTrashFolderName; 

String mOutboxFolderName; 

int mAccountNumber; 

boolean mVibrate; 

String mRingtoneUri; 

int mDeletePolicy; 

// 初 始 化 

public Account(Context context) ( 
mUuid = UUID.randomUUID().toString(); 
mLocalStoreUri = "local://localhost/" + context.getDatabasePath 

(mUuid + ".db"); 

mAutomaticCheckIntervalMinutes = -1; 
mAccountNumber = -1; 
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mNotifyNewMail = true; 
mVibrate = false; 
mRingtoneUri = "content://settings/system/notification sound"; 


} 
// 剧 新 指定 用 户 
Rccount (Preferences preferences，String uuid) { 
this.mUuid = uuid; 
refresh (preferences); 
H 
// 刷 新 
public void refresh(Preferences preferences) ( 
mStoreUri = Utility.base64Decode (preferences .mSharedPreferences.getString 
(mUuid + ".storeUri", null)); 


(1) 通过 SharedPreferences 对 象 的 getString0 方 法 取得 保存 在 其 中 的 值 。 对 应 代码 如 下 : 


mLocalStoreUri = preferences.mSharedPreferences.getString(mUuid + 
".localStoreUri", null); 

String senderText - preferences.mSharedPreferences.getString (mUuid 
* ".senderUri", null); 

if (senderText == null) ( 
// 获 取 ID 
senderText = preferences.mSharedPreferences.getString(mUuid + 

".transportUri", null); 


) 

// 转 换 编码 方式 

mSenderUri = Utility.base64Decode (senderText) ; 

mDescription = preferences.mSharedPreferences.getString(mUuid + 
".description", null); 


// 获 取 与 此 用 户 身份 有 关 的 信息 

mName = preferences.mSharedPreferences.getString(mUuid + ".name", 
mName) ; 

mEmail = preferences.mSharedPreferences.getString(mUuid + ".email", 
mEmail) ; 


mAutomaticCheckIntervalMinutes = preferences.mSharedPreferences.getInt 
(mUuid + ".automaticCheckIntervalMinutes", -1); 

mLastAutomaticCheckTime = preferences .mSharedPreferences.getLong 
(mUuid + ".lastAutomaticCheckTime", 0); 

mNotifyNewMail = preferences.mSharedPreferences.getBoolean 
(mUuid + ".notifyNewMail", false); 

mDraftsFolderName = preferences.mSharedPreferences.getString 
(mUuid + ".draftsFolderName", "Drafts"); 

mSentFolderName = preferences.mSharedPreferences.getString 
(mUuid + ".sentFolderName", "Sent"); 

mTrashFolderName - preferences.mSharedPreferences.getString 
(mUuid + ".trashFolderName", "Trash"); 

mOutboxFolderName = preferences.mSharedPreferences.getString 
(mUuid + ".outboxFolderName", "Outbox"); 

mAccountNumber — preferences.mSharedPreferences.getInt 
(mUuid + ".accountNumber", 0); 

mVibrate = preferences.mSharedPreferences.getBoolean 
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(mUuid + ".vibrate", false); 
mRingtoneUri = preferences.mSharedPreferences.getString 
(mUuid + ".ringtone", 
"content://settings/system/notification sound") ; 
} 
public String getUuid() { 
return mUuid; 
} 
public String getStoreUri() { 
return mStoreUri; 
H 


(2) 通过 各 属性 的 set0 方 法 赋值 。 对 应 代码 如 下 : 
// 为 属性 赋值 


public void setStoreUri (String storeUri) { 

this.mStoreUri = storeUri; 

} 

public String getSenderUri() { 
return mSenderUri; 

} 

public void setSenderUri(String senderUri) { 
this.mSenderUri = senderUri; 

) 

public String getDescription() ( 
return mDescription; 

} 

public void setDescription(String description) ( 
this.mDescription - description; 

) 

public String getName() ( 
return mName; 

) 

public void setName(String name) ( 
this.mName = name; 

) 

public String getEmail() ( 
return mEmail; 

} 

public void setEmail (string email) { 
this.mEmail = email; 

} 

public boolean isVibrate() { 
return mVibrate; 

} 

public void setVibrate (boolean vibrate) { 
mVibrate = vibrate; 

} 

public String getRingtone() { 
return mRingtoneUri; 
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public void setRingtone(String ringtoneUri) ( 
mRingtoneUri = ringtoneUri; 
} 


(3) 定义 delete0 方 法 删除 指定 的 Account 实例 ， 对 象 SharedPreferences.Editor 中 的 
Remove() 方 法 执行 删除 值 操作 。commit0 方 法 对 所 做 的 修改 提交 。 对 应 代码 如 下 : 


public void delete (Preferences preferences) { 

String[] uuids = preferences.mSharedPreferences.getString 

(Waccountuuids™;, =W) splitt" Ie 
StringBuffer sb = new StringBuffer (); 
for (int i = 0, length = uuids.length; i < length; i++) { 

if (!uuids[i].equals (mUuid)) { 
if (sb.length() > 0) { 
Sb.append(','); 


) 
Sb.append (uuids[il); 


) 

String accountUuids - sb.toString(); 
//5s& X SharedPreferences.Editor 对 象 ， 对 指定 值 的 清除 
SharedPreferences.Editor editor = preferences.mSharedPreferences.edit (); 
editor.putString("accountUuids", accountUuids) ; 
editor.remove (mUuid + ".storeUri"); 
editor.remove (mUuid + ".localStoreUri"); 
editor.remove (mUuid + ".senderUri"); 
editor.remove(mUuid + ".description") ; 
editor.remove (mUuid + ".name") ; 
editor. remove (mUuid + ".email"); 
editor.remove (mUuid + ".automaticCheckIntervalMinutes") ; 
editor.remove (mUuid + ".lastAutomaticCheckTime") ; 
editor.remove(mUuid + ".notifyNewMail") ; 
editor.remove (mUuid + ".deletePolicy"); 
editor.remove (mUuid + ".draftsFolderName") ; 
editor.remove (mUuid + ".sentFolderName") ; 
editor.remove (mUuid + ".trashFolderName") ; 
editor.remove (mUuid + ".outboxFolderName") ; 
editor.remove (mUuid + ".accountNumber") ; 
editor.remove (mUuid + ".vibrate"); 
editor.remove (mUuid + ".ringtone") ; 
editor.remove(mUuid + ".transportUri") ; 

// 提交 所 做 的 操作 

editor.commit(); 

} 


(4) 定义 save0 方 法 保存 指定 的 Account 实例 ， 对 象 SharedPreferences.Editor 中 的 方法 
putStringO 保 存 指定 的 值 ， 该 方法 的 第 一 个 参数 是 键 名 ， 第 二 个 参数 是 值 。 对 应 代码 如 下 : 
public void save(Preferences preferences) ( 
if (!preferences.mSharedPreferences.getString("accountUuids", 


"").contains (mUuid)) { 
Account[] accounts = preferences.getAccounts (); 
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int[] accountNumbers = new int[accounts.length]; 
for (int i = 0; i < accounts.length; i++) ( 
accountNumbers[i] = accounts [i] .getAccountNumber () ; 
} 
Arrays.sort (accountNumbers) ; 
for (int accountNumber : accountNumbers) { 
if (accountNumber > mAccountNumber + 1) { 
break; 
} 
mAccountNumber = accountNumber; 
b 
mAccountNumber++; 
String accountUuids = preferences .mSharedPreferences.getString 
("accountUuids", ""); 
accountUuids += (accountUuids.length() != 0 ? "," : "") + mUuid; 
SharedPreferences.Editor editor = preferences .mSharedPreferences.edit (); 
// 保存 accountUuids 名 的 值 
editor.putString("accountUuids", accountUuids); 
// 提交 所 做 的 操作 
editor.commit (); 
} 
SharedPreferences.Editor editor = preferences.mSharedPreferences.edit (); 
editor.putString(mUuid + ".storeUri", Utility.base64Encode (mStoreUri)); 
editor.putString(mUuid + ".localStoreUri", mLocalStoreUri); 
editor.putString(mUuid + ".senderUri", Utility.base64Encode (mSenderUri) ) ; 
editor.putString(mUuid + ".description", mDescription) ; 
editor.putString(mUuid + ".name", mName) ; 
editor.putString(mUuid + ".email", mEmail); 
editor.putInt (mUuid + ".automaticCheckIntervalMinutes", 
mAutomaticCheckIntervalMinutes); 
editor.putLong (mUuid + ".lastAutomaticCheckTime", mLastAutomaticCheckTime) ; 
editor.putBoolean(mUuid + ".notifyNewMail", mNotifyNewMail) ; 
editor.putInt (mUuid + ".deletePolicy", mDeletePolicy) ; 
editor.putString(mUuid + ".draftsFolderName", mDraftsFolderName) ; 
editor.putString(mUuid + ".sentFolderName", mSentFolderName) ; 
editor.putString(mUuid + ".trashFolderName", mTrashFolderName) ; 
editor.putString(mUuid + ".outboxFolderName", mOutboxFolderName) ; 
// 保存 整 型 数据 
editor.putInt (mUuid + ".accountNumber", mAccountNumber) ; 
//， 保存 逻辑 型 数据 
editor.putBoolean (mUuid + ".vibrate", mVibrate); 
editor.putString(mUuid + ".ringtone", mRingtoneUri); 
editor.remove (mUuid + ".transportUri"); 
editor.commit (); 


16.3.2 SharedPreferences 


定义 Preferences.java 类 ， 该 类 基于 类 SharedPreferences。 使 用 方法 getSharedPreferences() 
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返回 mSharedPreferences 对 象 ， 返 回 功能 对 应 的 代码 如 下 : 


public class Preferences ( 
private static Preferences preferences; 
SharedPreferences mSharedPreferences; 
private Preferences(Context context) { 
// 读 取 数据 
mSharedPreferences = context.getSharedPreferences ("AndroidMail.Main", 
Context.MODE PRIVATE); 


} 
public static synchronized Preferences getPreferences (Context context) { 


if (preferences == null) { 
preferences = new Preferences (context); 
} 
return preferences; 
} 


(1) 定义 getAccounts() 方 法 ， 返 回 accountUuids 对 应 的 值 。 对 应 代码 如 下 : 


public Account[] getAccounts() { 
String accountUuids = mSharedPreferences.getString("accountUuids", null); 
if (accountUuids == null || accountUuids.length() == 0) { 
return new Account[] {}; 
} 
String[] uuids = accountUuids.split(","); 
Account[] accounts = new Account [uuids.length]; 
for (int i = 0, length = uuids.length; i < length; i++) { 
accounts[i] = new Account(this, uuids[i]); 
} 
return accounts; 
} 


(2) 定义 getAccountByContentUri() 方 法 ， 返 回 指定 邮箱 类 型 对 应 的 URL 值 。 对 应 代码 
如 下 : 


public Account getAccountByContentUri (Uri uri) { 
if (!"content".equals(uri.getScheme()) || !"accounts".equals 
(uri.getAuthority())) { 
return null; 
b 
String uuid - uri.getPath().substring(1); 
if (uuid == null) { 
return null; 
H 
String accountUuids = mSharedPreferences.getString("accountUuids", null); 
if (accountUuids == null || accountUuids.length() == 0) ( 
return null; 
} 
String[] uuids = accountUuids.split(","); 
for (int i = 0, length = uuids.length; i < length; i++) { 
if (uuid.equals (uuids[il)) { 
return new Account(this, uuid); 
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} 
return null; 


5 
(3) 定义 getDefaultAccount () 方 法 ， 返 回 默认 的 用 户 ID。 对 应 代码 如 下 : 


public Account getDefaultAccount() { 
String defaultAccountUuid = mSharedPreferences.getString 
("defaultAccountUuid", null); 
Account defaultAccount = null; 
Account[] accounts = getAccounts(); 
if (defaultAccountUuid !- null) ( 
for (Account account : accounts) { 
if (account.getUuid().equals (defaultAccountUuid)) ( 
defaultAccount = account; 
break; 


} 
if (defaultAccount == null) { 
if (accounts.length > 0) { 
defaultAccount = accounts[0]; 
setDefaultAccount (defaultAccount) ; 


} 
return defaultAccount; 

} 

public void setDefaultAccount (Account account) { 
mSharedPreferences.edit () .putString ("defaultAccountUuid", 

account .getUuid()) .commit (); 
} 
(4) 定义 setEnableDebugLogging () 方 法 赋值 是 否 开启 调试 信息 ， 该 方法 读 取 调试 信息 
开启 情况 ， 对 应 代码 如 下 : 

public void setEnableDebugLogging (boolean value) { 
mSharedPreferences .edit () .putBoolean ("enableDebugLogging", value) .commit () ; 

} 

public boolean geteEnableDebugLogging() { 
return mSharedPreferences.getBoolean("enableDebugLogging", false); 

) 

public void setEnableSensitiveLogging (boolean value) ( 

// 直 接 修改 enablesensitiveLogging 的 值 

mSharedPreferences.edit () .putBoolean ("enableSensitiveLogging", 
value).commit(); 

} 

public boolean getEnableSensitiveLogging() { 
return mSharedPreferences.getBoolean ("enableSensitiveLogging", false); 


} 
public void save() ( 
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public void clear() ( 
// 清 除 对 象 里 的 键 名 
mSharedPreferences.edit () .clear() .commit (); 
} 
public void dump() { 
if (Config.LOGV) { 
for (String key : mSharedPreferences.getAll().keySet()) { 
Log.v(Email.LOG TAG, key + " = " + mSharedPreferences. 
getA11().get (key) ); 


164 具体 编码 


经 过 前 面 内 容 的 讲解 ， 本 项 目的 前 期 工作 已 经 结束 。 在 接 下 来 的 内 容 中 ， 将 详细 讲解 
本 项 目的 具体 编码 过 程 。 


16.4.1 欢迎 界面 
欢迎 界面 是 整个 项 目的 入 口 ， 通 过 入 口 可 进入 到 系统 的 其 他 功能 。 欢 迎 界 面 如 图 16-9 
所 示 。 
I 5554: android2. 2 


HELLO!, Welcome to Email setup! 


Use any email account with Email. 


Most popular email accounts can 
be set up in 2 steps! 


图 16-9 欢迎 界面 
(1) 编写 文件 WelActivityjava， 在 此 定义 项 目的 欢迎 界面 ， 主 要 代码 如 下 。 
O 定义 WelActivity 类 继承 ListActivity 类 ，ListActivity 类 又 继承 Activity。ListActivity 
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默认 绑 定 了 一 个 ListView( 列 表 视 图 ) 界 面 组 件 ， 提 供 一 些 与 视图 、 处 理 相关 的 操作 。 


public class WelActivity extends ListActivity implements 
OnItemClickListener, OnClickListener{ 
private static final String EXTRA ACCOUNT - "account"; 
protected void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
// Wi activity wel.xml 布局 
setContentView(R.layout.activity wel); 
ListView listView = getListView(); 
listView.setOnItemClickListener (this); 
listView.setItemsCanFocus (false); 
// 获 取 指 定 的 组 件 
listView.setEmptyView (findViewById(R.id.empty) ); 
findViewById(R.id.add new account) .setOnClickListener (this) ; 


} 
public void onItemClick (AdapterView<?> parent, View argl, int 
position, long arg3) { 
Account account = (Account) parent.getItemAtPosition (position); 
Intent intent = new Intent(this, EmailCpsActivity.class); 
// 启 动 前 传 值 在 Rctivity 里 
intent.putExtra (EXTRA ACCOUNT , account); 
/ / H8] Activity 
startActivity (intent); 
) 


@ 定义 onResume() 方 法 ， 该 方法 在 窗口 暂停 后 回调 。 所 有 窗 体 都 继承 Activity 类 ， 因 
此 在 窗 体 设计 类 中 都 应 该 包含 此 类 方法 ， 另 外 与 窗 体 调用 有 关 的 方法 有 onStart() 方 法 、 
onCreate() 方 法 、onPause() 方 法 、onStop0 方 法 、onRestart() 方 法 和 onDestroy0 方 法 。 


public void onClick(View v) ( 
if (v.getId() == R.id.add new account) ( 
Intent intent - new Intent(this, AccountSetupActivity.class); 
intent.setFlags(Intent.FLAG ACTIVITY CLEAR TOP); 
startActivity(intent); } 


// 暂 停 后 调用 

public void onResume() { 
super.onResume () ; 
refresh(); 

} 

// 刷 新 操作 

private void refresh() { 
Account[] accounts = Preferences.getPreferences (this) .getAccounts () ; 
getListView().setAdapter(new AccountsAdapter (accounts)); 

} 

@override 
class AccountsAdapter extends ArrayAdapter<Account> { 

public AccountsAdapter(Account[] accounts) { 

super (WelActivity.this, 0, accounts); 
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public View getView(int position, View convertView, ViewGroup parent) { 
Account account = getItem (position); 


View view; 


if (convertView != null) { 
view = convertView; 
yelse ( 


view = getLayoutInflater().inflate(R.layout.accounts item, parent, false); 

$ 

AccountViewHolder holder = (AccountViewHolder) view.getTag(); 

if (holder -- null) ( 
holder - new AccountViewHolder(); 
holder.description - (TextView) view.findViewById 

(R.id.description); 

holder.email = (TextView) view.findViewById(R.id.email); 
view.setTag (holder); 

} 

holder.description.setText (account .getDescription ()); 

holder.email.setText (account.getEmail()); 

if (account.getEmail() .equals(account.getDescription())) { 
holder.email.setVisibility (View.GONE) ; 

} 

return view; 

} 
class AccountViewHolder { 
public TextView description; 
public TextView email; 


} 
} 


(2) Android 是 可 视 化 界面 开发 ， 每 个 窗口 都 有 唯一 的 布局 XML 配置 文件 ， 窗 口 的 各 
种 布局 效果 都 有 对 应 的 标签 表示 。 比 如 图 像 、 文 字 和 控件 位 置 的 设置 等 ， 程 序 在 运行 时 读 
取 配 置 文件 ， 满 足 不 同 的 界面 应 用 。 

本 实例 主 界面 的 布局 文件 是 AndroidManifestxml， 主 要 代码 如 下 : 

<?xml version-"1.0" encoding-"utf-8"?» 

<LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 

android:orientation-"vertical" 


android:layout width-"fill parent" 
android:layout height-"fill parent" 


= 

<ListView 
android: id="@android:id/list" 
android:layout width="fill parent" 
android:layout height="wrap content" 
android:layout weight="1.0" 
/> 

<LinearLayout 
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android:id="@+id/empty" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:orientation-"vertical"» 
<TextView 
android:layout width="fill parent" 
android:layout height="wrap content" 
android: textSize="20sp" 
android:text="@string/accounts welcome" 
android: textColor="?android:attr/textColorPrimary" /> 
<View 
android:layout width="fill parent" 
android:layout height="0px" 
android:layout weight="1" /> 
</LinearLayout> 
<RelativeLayout 
android:layout width="fill parent" 
android:layout height-"54dip" 
android:background-"G8android:drawable/menu full _ frame"> 
«Button 
android:id="@+id/add new account" 
android:layout width-"wrap content" 
android:minWidth="100dip" 
android:layout height="wrap content" 
android:text="@string/next action" 
android: drawableRight="@drawable/button indicator next" 
android: layout_alignParentRight="true" 
android:layout centerVertical="true" /> 
</RelativeLayout> 
</LinearLayout> 


以 上 代码 中 采用 LinearLayout 布局 ，android:orientation="vertical" 实 现 控件 水 平方 向 排 
列 ，android:orientation="horizontal" 实 现 控件 竖 直 排列 。 标 签 RelativeLayout 布局 提供 一 个 
容器 ， 所 有 控件 在 容器 中 的 位 置 按 相 对 位 置 来 计算 。 

Android:id 定义 组 件 的 ID， 程序 根据 ID 可 以 访问 相应 的 的 控件 。 代 码 中 定义 了 list. 
empty 和 add_new_account， 分 别 表示 ListView 组 件 、LinearLayout 组 件 和 Button 组 件 。 
android:layout width-"fill parent" 和 android:layout height="wrap_content" 表 示 控 制 宽度 占 
全 屏 ， 控 制 的 高 度 适 应 容器 的 大 小 。 总 之 ，fil_parent 就 是 让 控件 宽 或 者 高 占 全 屏 ， 而 
wrap content 是 让 控件 的 高 或 宽 仅 仅 把 控件 里 的 内 容 包 右 住 ， 而 不 是 全 屏 。 


1642 ”系统 主 界面 
系统 根据 输入 的 用 户 名 和 密码 ， 设 置 用 户 的 属性 ， 如 图 16-10 所 示 。 
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[DETTA 


图 16-10 HARE 


(1) 编写 文件 AccountSetupActivity.java， 在 此 定义 用 户 设置 界面 ， 主 要 代码 如 下 。 

(D 定义 onCreate 方法 初始 化 窗 体 ， 方 法 参数 savedInstanceState 保存 当前 Activity 的 
状态 信息 。 定 义 监听 器  setOnClickListener() 、 addTextChangedListener 和 
addTextChangedListener()。 对 应 代码 如 下 : 


public class AccountSetupActivity extends Activity implements 

OnClickListener, TextWatcher( 

private final static int DIALOG NOTE - 1; 

private EmailAddressValidator mEmailValidator = new 

EmailAddressValidator(); 

private EditText mEmailView; 

private EditText mPasswordView; 

private Button mNextButton; 

private Account mAccount; 

private Provider mProvider; 

GOverride 

public void onCreate (Bundle savedInstanceState) ( 
super.onCreate (savedInstanceState); 
//Wi activity account setup. XML 布局 文件 
setContentView(R.layout.activity account setup); 
mEmailView = (EditText)findViewById(R.id.account email); 
mPasswordView = (EditText)findViewById(R.id.account password); 
mNextButton = (Button)findViewById(R.id.next); 
// 定 义 监听 器 
mNextButton.setOnClickListener (this); 
mEmailView.addTextChangedListener (this); 
mPasswordView.addTextChangedListener (this); 

) 


© 定义 onCreateDialog(0 方 法 创建 一 个 对 话 框 ， 方 法 参数 表示 对 话 框 ID. 
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AlertDialog.Builder(this) 创 建 一 个 AlertDialog 对 话 框 ，setIcon() 方 法 设置 对 话 框图 片 
setTitle() 方 法 设置 显示 标题 ，setMessage() 方 法 定义 提示 信息 内 容 。setPositiveButton() 方 法 
设置 确定 按钮 的 一 些 属性 ， 第 一 个 参数 为 按钮 上 的 显示 内 容 ; 第 二 个 参数 为 
DialogInterface.OnClickListener() 监 听 器 对 象 ， 监 听 单 击 事件 。 对 应 代码 如 下 : 

// 创 建 一 个 对 话 框 


public Dialog onCreateDialog(int id) ( 
if (id == DIALOG NOTE) ( 
if (mProvider != null && mProvider.note != null) ( 
return new AlertDialog.Builder (this) 
-setIcon(android.R.drawable.ic dialog alert) 
.setTitle(android.R.string.dialog alert title) 
.SetMessage (mProvider.note) 
-setPositiveButton( 
getString(R.string.okay action), 
new DialogInterface.OnClickListener() ( 
public void onClick(DialogInterface dialog, 
int which) ( 
finishAutoSetup(); 


} 
}) 

.setNegativeButton( 
getString(R.string.cancel action), 
null) 

.create(); 


} 
return null; 
} 


© 当 用 户 单 击 “ 确 定 ” 按 钮 后 调用 finishAutoSetup() 方 法 ， 实 例 化 URI 对 象 保存 用 
户 邮件 的 详细 信息 。 如 : 用 户 名 、 密 码 、 主 机 地 址 和 端口 。 最 终 封装 在 Account 类 的 实例 
mAccount， 调 用 对 应 的 set0 方 法 赋值 。 邮 件 用 户 设 置 不 正确 时 调用 onManualSetup0 方 
法 ， 若 用 户 设 置 正确 时 则 调用 actionCheckSettings() 方 法 。 对 应 代码 如 下 : 


private void finishAutoSetup() { 

String email = mEmailView.getText().toString().trim(); 

String password = mPasswordView.getText () .toString() .trim(); 

String[] emailParts = email.split("@"); 

String user = emailParts[0]; 

String domain = emailParts[1]; 

URI incomingUri = null; 

URI outgoingUri = null; 

try { 
String incomingUsername = mProvider.incomingUsernameTemplate; 
incomingUsername = incomingUsername.replaceAl1("\\$email", email); 
incomingUsername = incomingUsername.replaceAll1("\\$user", user); 
incomingUsername = incomingUsername.replaceAll("\\$domain", domain); 
URI incomingUriTemplate = mProvider.incomingUriTemplate; 
incomingUri = new URI (incomingUriTemplate.getScheme(), 
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incomingUsername + ":" 
+ password, incomingUriTemplate.getHost(), 
incomingUriTemplate.getPort(), null, 
null, null); 
String outgoingUsername - mProvider.outgoingUsernameTemplate; 
outgoingUsername = outgoingUsername.replaceAll("\\$email", email); 
outgoingUsername = outgoingUsername.replaceAll("\\$user", user); 
outgoingUsername = outgoingUsername.replaceAll("NX$domain", domain); 
URI outgoingUriTemplate = mProvider.outgoingUriTemplate; 
outgoingUri = new URI (outgoingUriTemplate.getScheme(), 
outgoingUsername + ":" 
+ password, outgoingUriTemplate.getHost(), 
outgoingUriTemplate.getPort(), null, 
null, nul); 
} catch (URISyntaxException use) { 
onManualSetup () ; 
return; 
} 
//% Account 对 象 的 属性 赋值 
mAccount = new Account (this); 
mAccount.setName (getOwnerName ()); 
mAccount.setEmail (email); 
mAccount.setStoreUri (incomingUri.toString()); 
mAccount.setSenderUri (outgoingUri.toString()); 
mAccount.setDraftsFolderName (getString(R.string.special mailbox name drafts)); 
mAccount.setTrashFolderName (getString (R.string.special mailbox name trash)); 
mAccount . setOutboxFolderName (getString(R.string.special mailbox name outbox)); 
mAccount . setSentFolderName (getString(R.string.special mailbox name sent)) ; 
if (incomingUri.toString().startsWith("imap")) { 
mAccount.setDeletePolicy(Account.DELETE POLICY ON DELETE); 
$ 
AccountCheckSettings.actionCheckSettings (this, mAccount, true, true); 
) 


@ 定义 getOwnerName() 方 法 获取 当前 用 户 ， 通 过 共享 数据 接口 取得 用 户 Account 对 
象 。getName(0) 返 回 具体 的 用 户 名 。 单 击 “ 向 下 ”按钮 调用 findProviderForDomain() 方 法 ， 
从 providers_product.xml 配置 文件 中 读 取 已 有 账户 信息 。 对 应 代码 如 下 : 


private String getOwnerName() { 
String name = null; 
// 通 过 SharedPreferences 对 象 取得 用 户 名 
Account account = Preferences.getPreferences (this) .getDefaultAccount () ; 
if (account != null) ( 
name = account.getName(); 
b 
return name; 
} 
private void onNext() { 
String email = mEmailView.getText().toString().trim(); 
String[] emailParts = email.split("Q"); 
String domain = emailParts[1].trim(); 
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mProvider = findProviderForDomain (domain); 


if (mProvider == null) { 
// 默 认 设置 用 户 调用 manual 
onManualsSetup () 7 
return; 
} 
if (mProvider.note != null) { 
// 显 示 对 话 框 


showDialog (DIALOG NOTE); 
} 
else { 

finishAutoSetup(); 


} 
private Provider findProviderForDomain(String domain) ( 
Provider p - findProviderForDomain (domain, 
R.xml.providers product); 
if (p == null) ( 
p = findProviderForDomain (domain, R.xml.providers) ; 
} 
return p; 
} 


© WR providers product 文件 中 没有 用 户 信息 ， 通 过 findProviderForDomain() 方 法 读 
取 Providers 文件 中 提供 接收 邮件 和 发 送 邮 件 的 服务 器 的 信息 。 最 后 将 id, lable, domain, 
uri 保存 在 Provider 实例 中 。 对 应 代码 如 下 : 


private String getxmlAttribute (XmlResourceParser xml, String name) { 
int resId = xml.getAttributeResourceValue (null, name, 0); 
if (resId == 0) { 
return xml.getAttributeValue (null, name); 
H 
else ( 
return getString(resId); 
H 


} 
// 读 取 资 源 文件 XML 


private Provider findProviderForDomain(String domain, int resourceId) 


try ( 
XmlResourceParser xml = getResources().getXml (resourceId); 
int xmlEventType; 
Provider provider - null; 


// 逐 行 读 取 XML 文件 
while ((xmlEventType — xml.next()) != XmlResourceParser.END DOCUMENT) ( 
if (xmlEventType == XmlResourceParser.START TAG 


&& "provider".equals (xml.getName ()) 
&& domain.equalsIgnoreCase (getXxmlAttribute (xml, 
"domain"))) ( 
provider - new Provider(); 


// 读 取 指 定 键 值 的 值 
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provider.id = getXmlAttribute (xml, "id"); 
provider.label = getXmlAttribute (xml, "label"); 
provider.domain = getXmlAttribute (xml, "domain"); 
provider.note = getXmlAttribute (xml, "note"); 
} 
else if (xmlEventType == XmlResourceParser.START TAG 
&& "incoming".equals (xml.getName () ) 
&& provider !- null) ( 
provider.incomingUriTemplate = new URI(getXmlAttribute (xml, "uri")); 
provider.incomingUsernameTemplate = getXmlAttribute (xml, "username"); 
} 
else if (xmlEventType == XmlResourceParser.START TAG 
&& "outgoing".equals (xml.getName () ) 
&& provider != null) { 
provider.outgoingUriTemplate = new URI (getxmlAttribute (xml, "uri")); 
provider .outgoingUsernameTemplate = getxmlAttribute (xml, "username") ; 
) 
else if (xmlEventType == XmlResourceParser.END TAG 
&& "provider".equals (xml.getName () ) 
&& provider != null) { 
return provider; 


} 
catch (Exception e) { 
Log.e(Email.LOG TAG, "Error while trying to load provider settings.", e); 
} 
return null; 
} 


© 定义 onManualSetup() 方 法 重新 设置 用 户 名 和 密码 ， 将 新 设 定 的 信息 封装 在 URI 3c 
例 中 。 若 设 定 失败 ，makeText( 方 法 在 主 界面 显示 出 错 内 容 。 设 定 用 户 名 和 密码 后 进入 
AccountSetupAccountType 对 象 的 actionSelectAccountType0 方 法 。 对 应 代码 如 下 : 


private void onManualSetup() { 
String email = mEmailView.getText().toString().trim(); 
String password = mPasswordView.getText () .toString() .trim(); 
String[] emailParts = email.split("@"); 
String user = emailParts[0].trim(); 
String domain = emailParts[1].trim(); 
mAccount = new Account (this); 
mAccount . setName (getOwnerName () ) ; 
mAccount .setEmail (email); 
try ( // 实 例 化 URL 实例 ， 为 URL 赋值 
URI uri = new URI("placeholder", user + ":" + password, domain, 
Si, dall, mull; nullis 
mAccount.setStoreUri (uri.toString()); 
mAccount.setSenderUri (uri.toString()); 
) catch (URISyntaxException use) { 
/ / URL 地 址 出 错 将 提示 


Toast.makeText(this,R.string.account setup username password 
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toast, Toast.LENGTH LONG).show(); 
mAccount = null; 
return; 
) //9) Account 对 象 的 属性 赋值 
mAccount.setDraftsFolderName (getString(R.string.special mailbox name drafts)); 
mAccount.setTrashFolderName (getString(R.string.special mailbox name trash)); 
mAccount.setOutboxFolderName (getString (R.string.special mailbox name outbox)); 
mAccount.setSentFolderName (getString (R.string.special mailbox name sent)); 
AccountSetupAccountType.actionSelectAccountType (this, mAccount, true); 
finish(); 
H 


C) 定义 onActivityResult0 方 法 接收 处 理 结果 ， 当 执行 完 finish), Activity 执行 结 
束 ， 并 且 将 返回 值 返回 给 调用 它 的 父 类 Activity 类 。onActivityResult() 方 法 的 第 一 个 参数 表 
示 Activity 请 求 码 ， 第 二 个 参数 表示 返回 结果 ， 结 果 码 最 常用 的 有 RESULT OK 和 
RESULT CANCELED， 前 者 表示 执行 成 功 ， 后 者 表示 取消 操作 。 对 应 代码 如 下 : 


// 根 据 指定 返回 码 执行 Activity 
protected void onActivityResult (int requestCode, int resultCode, 
android.content.Intent data) ( 
if (resultCode -- RESULT OK) ( 
mAccount.setDescription (maccount.getEmail()); 
mAccount.save (Preferences .getPreferences (this) ); 
Preferences.getPreferences (this) . setDefaultAccount (mAccount) ; 
AccountSetupNames.actionSetNames (this, mAccount); 
finish(); 


) 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
requestWindowFeature (Window.FEATURE NO TITLE); 
setContentView (R. layout.main) ; 
systemProvider=new SystemService (this); 
cursor-systemProvider.allSongs(); 
// MUSIC 键 值 的 值 
SharedPreferences sp = getSharedPreferences ("MUSIC",MODE WORLD READABLE); 
if (sp != null) ( 
playingName = sp.getString("PLAYINGNAME", null); 
selectName = sp.getString("SELECTNAME", null); 
String s = sp.getString("MUSIC LIST", null); 
if (s != null) 
music List = StringHelper.spiltString(s); 
} 


(2) 系统 主 界面 的 布局 文件 是 activity_account_setup.xml， 主 要 代码 如 下 : 


«?xml version-"1.0" encoding-"utf-8"?» 

<LinearLayout 
xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"match parent" 
android:layout height-"match parent" 
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android:orientation="vertical"> 

<EditText 
android:id="@+id/account email" 
android:hint="@string/account setup basics email hint" 
android: inputType="textEmailAddress" 
android: imeOptions="actionNext" 
android:layout height="wrap content" 
android:layout width-"fill parent" 
V 

<EditText 
android: id="@+id/account password" 
android:hint="@string/account setup basics password hint" 
android: inputType="textPassword" 
android: imeOptions="actionDone" 
android:layout height="wrap content" 
android:layout width="fill parent" 
android:nextFocusDown="@+id/next" 


/> 
<View 
android:layout width="fill parent" 
android:layout height="0px" 
android:layout weight="1" 
/> 
<RelativeLayout 
android:layout width="fill parent" 
android: layout height-"54dip" 
android:background="@android:drawable/menu full frame" 
> 
<Button 
android:id="@+id/next" 
android:text="@string/next action" 
android:layout height-"wrap content" 
android:layout width-"wrap content" 
android:minWidth-"100dip" 
android:drawableRight="@drawable/button indicator next" 
android:layout alignParentRight-"true" 
android:layout centerVertical-"true" 
/> 
</RelativeLayout> 
</LinearLayout> 


以 上 代码 layout_height="match_parent"'}, match parent 和 fill_parent 其 实效 果 一 样 。 


nextFocusDown 定义 单 击 Down 键 时 ，account password 文本 框 获 得 焦点 。 
nextFocusUp 定义 单 击 Up 键 时 某 组 件 获 得 焦点 、nextFocusLeft 定义 单 击 Left 键 时 某 组件 


获得 焦点 和 nextFocusRight 定义 点 击 Right 键 时 某 组 件 获得 焦点 。 

inputType 定义 该 组 件 是 输入 框 类 型 。 

imeOptions 指定 输入 法 窗口 中 的 回 车 键 功能 ，actionDone 表示 软 键盘 下 方 变 成 “ 完 
成 ”， 单 击 后 光标 保持 在 原来 的 输入 框 上 ， 并 且 软 键盘 关闭 。 其 他 可 选 值 为 normal、 


actionNext、actionSearch 等 。 
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16.4.3 ”邮箱 类 型 设置 


在 输入 用 户 名 和 密码 后 ， 单 击 Next 按钮 ， 将 弹出 邮箱 类 型 设置 界面 ， 如 图 16-11 所 示 。 


PIA 


图 16-11 邮箱 类 型 设置 界面 


(1) 编写 文件 AccountSetupAccountTypejava， 在 此 定义 邮箱 类 型 设置 界面 ， 主 要 代码 
如 下 。 

(D 定义 onCreate 方法 初始 化 窗 体 ， 为 Button 对 象 定义 监听 器 setOnClickListener(). 
其 中 Context 参数 将 接收 从 主 界面 窗 体 传送 的 数据 ， 利 用 actionSelectAccountType() 方 法 做 
初始 化 操作 ，Intent() 方 法 使 程序 执行 跳 转 到 AccountSetupAccountType 实例 。putExtra() 方 
法 以 键 值 对 的 形式 保存 数据 。 对 应 代码 如 下 : 


public class AccountSetupAccountType extends Activity implements 
OnClickListener ( 
private static final String EXTRA ACCOUNT = "account"; 
private static final String EXTRA MAKE DEFAULT = "makeDefault"; 
private Account mAccount; 
private boolean mMakeDefault; 
// 初 始 化 
public static void actionSelectAccountType (Context context, Account 
account, boolean makeDefault) ( 
Intent i - new Intent(context, AccountSetupAccountType.class); 
//} EXTRA ACCOUNT 指定 的 键 赋值 
i.putExtra(EXTRA_ACCOUNT, account); 
i.putExtra (EXTRA MAKE DEFAULT, makeDefault); 
/ [JA Activity 
context.startActivity (i); 
) 
// 创 建 一 个 窗 体 


public void onCreate (Bundle savedInstanceState) { 
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super .onCreate (savedInstanceState); 
// 加 载 activity account setup type 布局 XML 文件 
setContentView(R.layout.activity account setup type); 
( (Button) findViewById (R.id.pop)).setOnClickListener (this); 
( (Button) findViewById (R.id.imap)).setOnClickListener (this); 
mAccount = (Account)getIntent ().getSerializableExtra (EXTRA ACCOUNT); 
mMakeDefault = (boolean)getIntent().getBooleanExtra 

(EXTRA MAKE DEFAULT, false); 


} 
© 定义 onPop() 方 法 保存 用 户 的 URL 地 址 ，getUserInfo() 方 法 取得 用 户 ，getHost( 方 
法 取得 主机 地 址 ，getPort0 方 法 取得 端口 。 此 处 的 uri 实例 对 象 表示 用 户 类 型 是 pop3 协议 
(允许 用 户 从 服务 器 上 把 邮件 存储 到 本 地 主机 )。 对 应 代码 如 下 所 示 。 


@override 
private void onPop() { 
try ( 
// 定 义 并 为 URI 实例 赋值 
URI uri = new URI (mAccount.getStoreUri ()); 
uri = new URI("pop3", uri.getUserInfo(), uri.getHost(), 
uri.getPort(), null, null, null); 
mAccount.setStoreUri (uri.toString()); 
) catch (URISyntaxException use) ( 
throw new Error(use); 
} 
AccountSetupIncoming.actionIncomingSettings (this, mAccount, 
mMakeDefault) ; 
/ [FT Activity 
finish(); 


) 
© 定义 onImap0 方 法 保存 用 户 的 URL 地 址 ， 此 处 的 URI 实例 对 象 表示 用 户 类 型 是 
imap 协议 (允许 用 户 在 线 与 邮件 服务 器 交互 信息 )。 无 论 是 采用 哪 种 通信 协议 都 要 调用 
actionIncomingSettings() 方 法 进入 用 户 收 取 邮 件 界 面 设置 ，onClick0 监 听 用 户 单 击 按钮 的 动 
作 。 对 应 代码 如 下 : 


private void onImap() { 
Eey dd 
// 定 义 并 为 URI 实例 赋值 
URI uri = new URI (mAccount.getStoreUri ()); 
uri = new URI("imap", uri.getUserInfo(), uri.getHost(), 
uri.getPort(), null, null, null); 
mAccount.setStoreUri (uri.toString()); 
) catch (URISyntaxException use) { 
throw new Error (use); 
H 
mAccount.setDeletePolicy(Account.DELETE POLICY ON DELETE); 
AccountSetupIncoming.actionIncomingSettings (this, mAccount, mMakeDefault); 
//4MAT Activity 
finish(); 
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} 
// 根 据 触发 的 组 件 调用 相应 的 方法 
public void onClick(View v) { 
switch (v.getId()) { 
case R.id.pop: 
onPop () 7 
break; 
case R.id.imap: 
onImap (); 
break; 


$ 
(2) 邮箱 类 型 设置 的 布局 文件 是 activity account setup type.xml, ERRU F: 


<?xml version-"1.0" encoding-"utf-8"?» 
<LinearLayout xml1ns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:orientation-"vertical" 
> 
<TextView 
android:text="@string/account setup account type instructions" 
android:layout height="wrap content" 
android: layout_width="fill parent" 
android: textAppearance="?android:attr/textAppearanceMedium" 
android: textColor="?android:attr/textColorPrimary" 
/> 
<Button 
android: id="@+id/pop" 
android:text="@string/account setup account type pop action" 
android:layout height="wrap content" 
android:layout width-"150dip" 
android:minWidth-"100dip" 
android:layout gravity-"center horizontal" 
/> 
<Button 
android: id="@+id/imap" 
android:text="@string/account setup account type imap action" 
android:layout height="wrap content" 
android:layout width="150sp" 
android:minWidth-"100dip" 
android:layout gravity-"center horizontal" 
/> 
</LinearLayout> 


以 上 代码 中 “android:textAppearance="?android:attr/textAppearanceMedium" ”引用 的 是 
系统 自 带 的 一 个 外 观 ，“? ”表示 系统 是 否 有 这 种 外 观 ， 否 则 使 用 默认 的 外 观 。Android 
系统 自 带 的 文字 外 观 设置 及 实际 显示 效果 图 的 设置 有 textappearancebutton 、 


textappearanceinverse. textappearancelarge. textappearancelargeinverse. textappearancemedium, 
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extappearancesmallinverse, textappearancemediuminverse fil textappearancesmall. 
“android:textColor="?android:attrtextColorPrimary"” 同 样 引用 的 是 系统 自 带 的 一 个 外 
观 。 设 置 界面 背景 及 文字 颜色 最 常用 的 两 种 方法 : 直接 在 布局 文件 中 设置 如 
“android:backgound="#FFFFFFFF", android:textcolor="#00000000"” 和 把 颜色 提取 出 来 形成 
资源 ， 放 在 资源 文件 (如 values/drawable/color.xml) 下 面 。 


«?xml version-"1.0" encoding="utf-8"?> 


«resources» 

«drawable name="white">#FFFFFFFF</drawable> 

<drawable name="black">#FF000000</drawable> 

</resources> 

然后 在 布局 文件 中 使 用 代码 android:backgound="@drawable/white", android:textcolor= 
"@drawable/black" 或 者 在 Java 文件 中 通过 代码 setBackgroundColor(int color) , 
setBackgroundResource(int resid), setTextColor(int color) 来 设置 。 


16.4.4 邮箱 收取 设置 


在 确定 邮件 类 型 后 ， 单 击 POP3 Account 或 者 Imap Account 按钮 ， 将 弹出 邮箱 收取 设 
置 界面 ， 如 图 16-12 所 示 。 
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图 16-12 ”邮箱 收取 设置 界面 


(1) 此 邮箱 收取 设置 界面 功能 是 通过 文件 AccountSetupIncoming.java 实现 的 ， 接 下 来 
F 始 讲解 此 文件 的 实现 流程 。 

(D 定义 actionIncomingSettings() 方 法 和 actionEditIncomingSettings() 方 法 做 数据 初始 化 
操作 ， 其 中 Context 参数 将 接收 从 主 界面 窗 体 传 送 的 数据 ，Intent() 方 法 使 程序 执行 跳 转 到 
AccountSetupIncoming 实例 ，putExtra() 方 法 以 键 值 对 的 形式 保存 数据 。startActivity() 方 法 
启动 在 不 同 Activity 间 切 换 。 对 应 代码 如 下 : 

private static final String EXTRA ACCOUNT = "account"; 
private static final String EXTRA MAKE DEFAULT — "makeDefault"; 


Pee aE 


H 
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// 初 始 化 端口 选项 


private static final int popPorts[] = ( 
Hokie 9951995; LLO 10 
bn 
private static final String popSchemes[] = { 
pop3< “pOps+ss iu. pop3tssir" DO *DOpSEETlSsT UU DODSIETU SE 
iG 
private static final int imapPorts[] - ( 
T43; 993; 993; 143, 143 
bg 
private static final String imapSchemes[] - ( 
"imap", "imap-*ssl", "imaptssl+", "imapt+tls", "imap+tls+" 
5 
private int mAccountPorts[]; 
private String mAccountSchemes[]; 
private EditText mUsernameView; 
private EditText mPasswordView; 
private EditText mServerView; 
private EditText mPortView; 
private Spinner mSecurityTypeView; 
private Spinner mDeletePolicyView; 
private EditText mImapPathPrefixView; 
private Button mNextButton; 
private Account mAccount; 
private boolean mMakeDefault; 
public static void actionIncomingSettings (Activity context, Account 
account, boolean makeDefault) ( 
// 定义 Intent WH, (Activity 跳 转 
Intent i = new Intent(context, AccountSetupIncoming.class); 
i.putExtra (EXTRA ACCOUNT, account); 
i.putExtra (EXTRA MAKE DEFAULT, makeDefault); 
/ [AS] Activity ( 
context.startActivity (i); 
) 
public static void actionEditIncomingSettings (Activity context, Account 
account) ( 
Intent i = new Intent(context, AccountSetupIncoming.class); 
i.setAction(Intent.ACTION EDIT); 
i.putExtra (EXTRA ACCOUNT, account); 
context.startActivity (i); 
} 


Q) Android 开发 中 的 四 大 组 件 包 含 : 活动 (Activity)、 服 务 (Services)、 广 播 接收 者 
(BroadcastReceiver) 和 内 容 提供 者 (ContentProvider)， 活 动 (Activity) 是 一 个 很 重要 的 部 分 ， 表 
示 一 个 可 视 化 的 用 户 界面 ， 关 注 用户 从 事 的 事件 ， 几 乎 所 有 的 活动 都 是 要 和 用 户 进行 交互 。 

图 定义 onCreate 方法 初始 化 窗 体 ， 定 义 了 Spinner 控件 ， 该 控件 主要 就 是 一 个 列表 。 
Spinner 是 View 类 的 一 个 子 类 ， 利 用 数组 的 赋值 方式 为 其 写 入 初 值 。 对 应 代码 如 下 。 


@override 
public void onCreate (Bundle savedInstanceState) { 


> Andid sssanAnsmia 


super .onCreate (savedInstanceState); 
// 加 载 activity account setup incoming 布局 XML 文件 
setContentView(R.layout.activity account setup incoming); 


mUsernameView = (EditText)findViewById(R.id.account username); 
mPasswordView = (EditText)findViewById(R.id.account password); 
TextView serverLabelView = (TextView) findViewById 


(R.id.account server label); 
mServerView = (EditText)findViewById(R.id.account server); 
mPortView = (EditText)findViewById(R.id.account port); 
mSecurityTypeView = (Spinner)findViewById(R.id.account security type); 
mDeletePolicyView = (Spinner)findViewById(R.id.account delete policy); 
mImapPathPrefixView = (EditText)findViewById(R.id.imap path prefix); 
mNextButton = (Button) findViewById(R.id.next) ; 
// 绑 定 监听 器 
mNextButton.setOnClickListener (this); 
SpinnerOption securityTypes[] = ( 
new SpinnerOption(0, getString(R.string.account setup 
incoming security none label)), 
new SpinnerOption(1, getString(R.string.account setup 
incoming security ssl optional label)), 
new SpinnerOption(2, getString(R.string.account setup 
incoming security ssl label)), 
new SpinnerOption(3, getString(R.string.account setup 
incoming security tls optional label)), 
new SpinnerOption(4, getString(R.string.account setup 
incoming security tls label)), 
n 
SpinnerOption deletePolicies[] = { 
new SpinnerOption(0, 
getString(R.string.account setup incoming delete policy never label)), 
new SpinnerOption(1, 
getstring(R.string.account setup incoming delete policy 7days label)), 
new SpinnerOption (2, 
getString(R.string.account setup incoming delete policy delete label)), 
n 


(à) ArrayAdapter 是 从 BaseAdapter 派生 出 来 的 ， 具 备 BaseAdapter 的 所 有 功能 ， 但 
ArrayAdapter 更 为 强大 ， 它 在 实例 化 时 可 以 直接 使 用 泛 型 构造 。ArrayAdapter 分 三 种 显示 
模式 ， 分 别 是 简单 的 、 样 式 丰富 的 但 内 容 简单 的 和 内 容 丰 富 的 。Android SDK 中 可 以 看 到 
android.widget.ArrayAdapter<T> 形 式 ，ArrayAdapter(Context context, int textViewResourceld) 
第 二 个 参数 直接 绑 定 一 个 layout。 对 应 代码 如 下 : 


ArrayAdapter«SpinnerOption» securityTypesAdapter = new 
ArrayAdapter«SpinnerOption» (this, 
android.R.layout.simple spinner item, securityTypes); 
securityTypesAdapter.setDropDownViewResource 
(android.R.layout.simple spinner dropdown item); 
mSecurityTypeView.setAdapter (securityTypesAdapter); 
ArrayAdapter<SpinnerOption> deletePoliciesAdapter = new 
ArrayAdapter<SpinnerOption> (this, 
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android.R.layout.simple spinner item, deletePolicies); 
deletePoliciesAdapter 
-setDropDownViewResource (android.R.layout.simple spinner 
dropdown item); 
mDeletePolicyView.setAdapter (deletePoliciesAdapter); 
mSecurityTypeView.setOnItemSelectedListener (new 
AdapterView.OnItemSelectedListener() ( 
public void onItemSelected(AdapterView arg0, View argl, int 
arg2, long arg3) ( 
updatePortFromSecurityType(); 
} 
public void onNothingSelected (AdapterView<?> arg0) { 
} 
n: 


© TextWatcher 实例 监控 EditText 组 件 输入 的 内 容 发 生 的 变化 ， 然 后 定义 
addTextChangedListener 监听 器 分 别 监控 用 户 名 、 密 码 、 服 务 和 端口 是 否 有 输入 内 容 ， 若 没 
全 部 输入 内 容 ， 则 Next 按钮 将 成 不 可 用 状态 。 对 应 代码 如 下 : 


TextWatcher validationTextWatcher = new TextWatcher() ( 
public void afterTextChanged(Editable s) ( 
validateFields(); 
b 
he 
// 定 义 监听 器 
mUsernameView.addTextChangedListener (validationTextWatcher); 
mPasswordView.addTextChangedListener (validationTextWatcher); 
mServerView.addTextChangedListener (validationTextWatcher); 
mPortView.addTextChangedListener (validationTextWatcher); 
if (savedInstanceState !- null && savedInstanceState.containsKey 
(EXTRA ACCOUNT)) ( 
// 取 得 mAccount 实例 
mAccount = (Account)savedInstanceState.getSerializable (EXTRA ACCOUNT); 
H 
try ( 
URI uri = new URI (mAccount.getStoreUri ()); 
String username - null; 
String password - null; 
if (uri.getUserInfo() != null) { 
String[] userInfoParts - uri.getUserInfo().split(":", 2); 
username = userInfoParts[0]; 
if (userInfoParts.length » 1) ( 
password = userInfoParts[l]:; 


if (username !- null) ( 
mUsernameView.setText (username); 


if (password != null) { 
mPasswordView.setText (password); 
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(8) getScheme() 方 法 返回 当前 请 求 所 使 用 的 协议 。 根 据 返 回 结果 为 mAccountPorts 变量 
设置 相应 的 值 。 对 应 代码 如 下 : 


mf 


(uri.getScheme().startsWith("pop3")) { serverLabelView.setText 
(R.string.account setup incoming pop server label); 
mAccountPorts = popPorts; 
mAccountSchemes = popSchemes; 
findViewById(R.id.imap path prefix section).setVisibility 
(View.GONE); 
} else if (uri.getScheme().startsWith ("imap")) 
( serverLabelView.setText (R.string.account setup 
incoming imap server label); 
mAccountPorts = imapPorts; 
mAccountSchemes = imapSchemes; findViewById 
(R.id.account delete policy label).setVisibility 
(View.GONE); 
mDeletePolicyView.setVisibility (View.GONE); 
if (uri.getPath() !- null && uri.getPath().length() > 0) ( 
mImapPathPrefixView.setText (uri.getPath().substring(1)); 
) 
) else ( 
throw new Error("Unknown account type: " + mAccount.getStoreUri ()); 
} 
for (int i = 0; i < mAccountSchemes.length; i++) { 
if (mAccountSchemes[i].equals(uri.getScheme())) { 
SpinnerOption.setSpinnerOptionValue (mSecurityTypeView, i); 


} 
SpinnerOption.setSpinnerOptionValue (mDeletePolicyView, 
mAccount.getDeletePolicy()); 
if (uri.getHost() != null) { 
mServerView.setText (uri.getHost ()); 
} 


if (uri.getPort() != -1) { 
mPortView.setText (Integer.toString(uri.getPort())); 
} else { 


updatePortFromSecurityType (); 
5 
) catch (URISyntaxException use) ( 
throw new Error (use); 


} 
// 检 查 组 件 里 内 容 的 变化 
validateFields(); 
} 


(2) 邮箱 收取 界面 的 布局 文件 是 activity_account_setup_incoming.xml， 主 要 代码 如 下 : 


«?xml version-"1.0" encoding-"utf-8"?» 
<ScrollView 
xmlns:android-"http://schemas.android.com/apk/res/android" 
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android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:scrollbarStyle-"outsideInset"» 
<LinearLayout 
android: layout_width="fill parent" 
android:layout height="fill parent" 
android: orientation="vertical"> 


<TextView 
android:id="@+id/account server label" 
android:text="@string/account setup incoming pop server label" 
android:layout height="wrap content" 
android:layout width="fill parent" 
android: textAppearance="?android:attr/textAppearanceSmall" 
android: textColor="?android:attr/textColorPrimary" /> 
<Spinner 
android: id="@+id/account security type" 
android:layout height="wrap content" 
android:layout width="fill parent" /> 
<TextView 
android: id="@+id/account delete policy label" 
android:text="@string/account setup incoming delete policy label" 
android:layout height-"wrap content" 
android:layout width-"fill parent" 
android:textAppearance-"?android:attr/textAppearanceSmall" 
android:textColor-"?android:attr/textColorPrimary" /> 
«Spinner 
android:id-"G«id/account delete policy" 
android:layout height-"wrap content" 
android:layout width-"fill parent" /» 
«View 
android:layout width-"fill parent" 
android:layout height="0px" 
android:layout weight-"1" /» 
<RelativeLayout 
android:layout width="fill parent" 
android: layout height-"54dip" 
android: background="@android:drawable/menu full frame"> 
<Button 
android: id="@+id/next" 
android:text="@string/next action" 
android:layout height="wrap content" 
android:layout width="wrap content" 
android:minWidth="100dip" 
android: drawableRight="@drawable/button indicator next" 
android:layout alignParentRight-"true" 
android:layout centerVertical-"true" /» 
«/RelativeLayout» 
</LinearLayout> 
</ScrollView> 
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VJ FIRE *android:drawableRight-"(gdrawable/button indicator next"” 中 ，drawable 在 
Android SDK 中 的 主要 作用 是 : 在 XML 中 定义 各 种 动画 ， 然 后 把 XML 当 作 drawable Yt 
源 来 读 取 ， 通 过 drawable 显示 动画 。 

drawable 就 是 一 个 可 画 的 对 象 ， 可 能 是 一 张 位 图 (bitmap drawable)， 也 可 能 是 一 个 图 形 
(shape drawable)， 还 有 可 能 是 一 个 图 层 (layer drawable)。 开 发 程序 时 为 了 兼容 不 同 平台 不 
同 屏幕 ， 所 以 要 求 建立 多 个 文件 夹 根据 需求 存放 不 同 屏幕 版 本 图 片 。 

在 Android SDK 2.1 版 本 中 有 drawable-mdpi、drawable-ldpi 和 drawable-hdpi 三 个 文件 
夹 ， 这 三 个 文件 夹 主要 是 为 了 支持 多 分 辨 率 。 系 统 运行 时 会 根据 机 器 的 分 辨 率 来 分 别 到 这 
几 个 文件 夹 中 去 找 对 应 的 图 片 。xhdpi 是 从 Android 2.2 (API Level 8) 开 始 增 加 的 分 类 。 
xlarge 是 从 Android 2.3 (API Level 9) 增 加 的 分 类 。 在 本 项 目 中 res/drawable-xhdpi/ 资 源 下 存放 
button_indicator_next.png 图 片 ， 另 外 在 以 上 三 个 目录 中 同样 有 此 名 字 的 图 片 。 


16.4.5 邮箱 发 送 设置 


在 设置 好 发 送 邮件 的 必要 信息 后 ， 单 击 Next 按钮 ， 将 弹出 邮箱 发 送 设置 界面 ， 如 图 16-13。 
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图 16-13 ”邮箱 发 送 设置 界面 


(1) 编写 文件 AccountSetupOutgoingjava， 在 此 定义 邮箱 发 送 设置 界面 。 

(D 定义 actionOutgoingSettings() 方 法 和 actionEditOutgoingSettings() 方 法 做 数据 初始 化 
操作 ， 其 中 Context 参数 将 接收 从 主 界面 窗 体 传送 的 数据 ，Intent() 方 法 使 程序 执行 跳 转 到 
AccountSetupOutgoing 实例 ，putExtra() 方 法 以 键 值 对 的 形式 保存 数据 。startActivity( 方 法 
启动 在 不 同 Activity 之 间 切 换 。 对 应 代码 如 下 : 

public class AccountSetupOutgoing extends Activity implements 

OnClickListener, 


OnCheckedChangeListener { 
private static final String EXTRA_ACCOUNT = "account"; 
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private static final String EXTRA MAKE DEFAULT = "makeDefault"; 
// 定 义 发 送 端口 
private static final int smtpPorts[] = ( 
25, 465, 465, 25, 25 
F 
private static final String smtpSchemes[] = { 
NsmEp"ro"smtprssPuEssmtprssire E Msmtprbts" a smtprt- sr 
Hn 
private EditText mUsernameView; 
private EditText mPasswordView; 
private EditText mServerView; 
private EditText mPortView; 
private CheckBox mRequireLoginView; 
private ViewGroup mRequireLoginSettingsView; 
private Spinner mSecurityTypeView; 
private Button mNextButton; 
private Account mAccount; 
private boolean mMakeDefault; 
public static void actionOutgoingSettings (Context context, Account 
account, boolean makeDefault) ( 
// 定 义 Intent Kil, Xf Activity 设 定 跳 转 到 AccountSetupOutgoing 
Intent i = new Intent (context, AccountSetupOutgoing.class) ; 
i.putExtra (EXTRA ACCOUNT, account); 
i.putExtra (EXTRA MAKE DEFAULT, makeDefault); 
// Až Activity 
context.startActivity (i); 
) 
public static void actionEditOutgoingSettings (Context context, 
Account account) ( 
Intent i = new Intent(context, AccountSetupOutgoing.class); 
i.putExtra (EXTRA ACCOUNT, account); 
context.startActivity (i); 
) 


@ 定义 onCreate(Bundle savedInstanceState) 方 法 初始 化 窗 体 ， 在 创建 Activity 时 调 
用 。 还 以 Bundle 的 形式 提供 对 以 前 储存 的 任何 状态 的 访问 。 对 应 代码 如 下 : 


@Override 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
// 加 载 界面 布局 文件 activity_account_setup_outgoing .XML 
setContentView(R.layout.activity account setup outgoing); 
mUsernameView = (EditText)findViewById(R.id.account username); 
mPasswordView = (EditText)findViewById(R.id.account password); 
mServerView = (EditText)findViewById(R.id.account server); 
mPortView = (EditText) findViewById(R.id.account port); 
mRequireLoginView = (CheckBox)findViewById(R.id.account require login); 
mRequireLoginSettingsView = (ViewGroup)findViewById 

(R.id.account require login settings); 

mSecurityTypeView = (Spinner)findViewById(R.id.account security type); 
mNextButton = (Button)findViewById(R.id.next); 
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mNextButton.setOnClickListener (this); 
// 定 义 监听 器 
mRequireLoginView.setOnCheckedChangeListener (this); 
SpinnerOption securityTypes[] = { 
new SpinnerOption(0, getString(R.string.account setup 
incoming security none label)), 
new SpinnerOption(1, getString(R.string.account setup 
incoming security ssl optional label)), 
new SpinnerOption(2, getString(R.string.account setup 
incoming security ssl label)), 
new SpinnerOption (3, 
getString(R.string.account setup incoming 
security tls optional label)), 
new SpinnerOption(4, getString(R.string.account setup 
incoming security tls label)), 
n 
ArrayAdapter«SpinnerOption» securityTypesAdapter - new 
ArrayAdapter«SpinnerOption» (this, 
android.R.layout.simple spinner item, securityTypes); 
securityTypesAdapter.setDropDownViewResource 
(android.R.layout.simple spinner dropdown item); 
mSecurityTypeView.setAdapter (securityTypesAdapter) ; 
mSecurityTypeView.setOnItemSelectedListener (new 
AdapterView.OnItemSelectedListener() ( 
// 树 型 组 件 点 击 后 触发 的 事件 
public void onItemSelected(AdapterView arg0, View argl, int 
arg2, long arg3) ( 
updatePortFromSecurityType(); 
b 
public void onNothingSelected(AdapterView«?» arg0) ( 
} 
We 
TextWatcher validationTextWatcher = new TextWatcher() { 
public void afterTextChanged (Editable s) { 
validateFields(); 
H 
n 
// 定 义 监听 器 
mUsernameView.addTextChangedListener (validationTextWatcher) ; 
mPasswordView.addTextChangedListener (validationTextWatcher) ; 
mServerView.addTextChangedListener (validationTextWatcher) ; 
mPortView.addTextChangedListener (validationTextWatcher) ; 
mPortView.setKeyListener (DigitsKeyListener.getInstance 
("0123456789") ) > 
mAccount = (Account)getIntent ().getSerializableExtra (EXTRA ACCOUNT); 
mMakeDefault = (boolean) getIntent () .getBooleanExtra 
(EXTRA MAKE DEFAULT, false); 
if (savedInstanceState != null && savedInstanceState.containsKey 
(EXTRA ACCOUNT)) ( 
mAccount — (Account)savedInstanceState.getSerializable (EXTRA ACCOUNT); 


0B 第 16 章 开发 一 个 邮件 系统 


validateFields(); 
} 
private void validateFields() { 
boolean enabled = 
Utility.requiredFieldValid (mServerView) && Utility.requiredFieldValid 
(mPortView); 
if (enabled && mRequireLoginView.isChecked()) { 
enabled - (Utility.requiredFieldValid (mUsernameView) 
&& Utility.requiredFieldValid (mPasswordView)); 


if (enabled) ( 
try { 
URI uri = getUri(); 
} catch (URISyntaxException use) { 
enabled = false; 


} 

mNextButton.setEnabled (enabled); 

Utility.setCompoundDrawablesAlpha (mNextButton, enabled ? 255 : 128); 
} 


@ 定义 TextWatcher 实例 监控 EditText 组 件 输入 的 内 容 发 生 的 变化 ， 然 后 定义 
addTextChangedListener 监听 器 分 别 监控 用 户 名 、 密 码 、 服 务 和 端口 是 否 有 输入 内 容 ， 若 没 
全 部 输入 内 容 ， 则 Next 按钮 将 成 不 可 用 状态 。 对 应 代码 如 下 : 


TextWatcher validationTextWatcher = new TextWatcher() { 
public void afterTextChanged (Editable s) { 
validateFields(); 
H 
public void beforeTextChanged(CharSequence s, int start, int count, 
int after) ( 
H 
public void onTextChanged(CharSequence s, int start, int before, 
int count) ( 
H 
n 
mUsernameView.addTextChangedListener (validationTextWatcher); 
mPasswordView.addTextChangedListener (validationTextWatcher); 
mServerView.addTextChangedListener (validationTextWatcher); 
mPortView.addTextChangedListener (validationTextWatcher) ; 


@ 定义 updatePortFromSecurityType() 方 法 ， 将 用 户 输入 的 端口 号 赋值 为 mPortView 4E 
量 。 dX dj mSecurityTypeView.getSelectedItem()).value 读 取 View 的 节点 值 ， 
onActivityResult() 方 法 检查 若 Activity 执行 是 否 成 功 。 对 应 代码 如 下 : 


private void updatePortFromSecurityType() ( 
int securityType = (Integer) ((SpinnerOption)mSecurityTypeView. 
getSelectedItem()).value; 
mPortView.setText (Integer.toString(smtpPorts[securityType]l)); 
$ 
@override 
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// onActivityResult 执行 完 Activity 后 ， 将 结果 返回 给 调用 它 的 父 Activity 
public void onActivityResult(int requestCode, int resultCode, Intent data) ( 
if (resultCode == RESULT OK) ( 

if (Intent.ACTION EDIT.equals (getIntent().getAction())) { 
mAccount . save (Preferences.getPreferences (this)); 
finish (); 

p else t 
AccountSetupOptions.actionOptions (this, mAccount, mMakeDefault); 
finish(); 


} 
private URI getUri() throws URISyntaxException { 
int securityType = (Integer) ((SpinnerOption)mSecurityTypeView. 
getSelectedItem()).value; 
String userInfo - null; 
if (mRequireLoginView.isChecked()) ( 
userInfo = mUsernameView.getText().toString().trim() + ":" 
+ mPasswordView.getText().toString().trim(); 
} 
URI uri = new URI( 
smtpSchemes [securityType], 
userInfo, 
mServerView.getText().toString().trim(), 
Integer.parseInt (mPortView.getText().toString().trim()), 
null, null, null); 
return uri; 
) 


© 定义 onClick() 方 法 ， 用 户 单 击 Next 按钮 后 触发 onNext() 方 法 。 在 该 方法 中 读 取 邮 
件 的 URL Jh hb, URL 地 址 包含 有 用 户 名 和 密码 等 信息 。 程 序 再 跳 转 到 
actionCheckSettings() 方 法 中 对 用 户 的 设置 进行 检查 。 


public void onClick(View v) { 
switch (v.getId()) { 
case R.id.next: 
onNext (); 
break; 
} 
} 
private void onNext() { 
try { 
URI uri = getUri(); 
mAccount.setSenderUri (uri.toString()); 
} catch (URISyntaxException use) { 
throw new Error (use); 


H 
// 检 查 用 户 
AccountCheckSettings.actionCheckSettings (this, mAccount, false, true); 
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(2) 邮箱 发 送 设 置 的 布局 文件 是 AccountSetupOutgoing.xml， 主 要 代码 如 下 : 


<?xml version-"1.0" encoding="utf-8"?> 
«ScrollView 
xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:scrollbarStyle-"outsideInset"» 
<LinearLayout 
android:layout width="fill parent" 
android:layout height="fill parent" 
android:orientation="vertical"> 
<TextView 
android:text="@string/account setup outgoing security label" 
android:layout height="wrap content" 
android:layout width="fill parent" 
android: textAppearance="?android:attr/textAppearanceSmall" 
android: textColor="?android:attr/textColorPrimary" /> 
<Spinner 
android: id="@+id/account security type" 
android:layout height="wrap content" 
android:layout width="fill parent" /> 
<CheckBox 
android:id="@+id/account require login" 
android:layout width="fill parent" 
android:layout height="wrap content" 
android:text="@string/account setup outgoing require login label" /> 
<LinearLayout 
android:id="@+id/account require login settings" 
android:layout width="fill parent" 
android: layout_height="fill_ parent" 
android:orientation="vertical" 
android: visibility="gone"> 
</LinearLayout> 
«/ScrollView» 


以 上 代码 中 “android:scrollbarStyle="outsideInset"” 引 用 的 是 系统 自 带 的 一 个 外 观 ， 

“? ”表示 系统 是 否 有 这 种 外 观 ， 否 则 使 用 默认 的 外 观 。Android 的 系统 自 带 的 文字 外 观 
设置 及 实际 显示 效果 图 的 设置 如 : textappearancebutton 、 textappearanceinverse 、 
textappearancelarge 、textappearancelargeinverse 、textappearancemedium、extappearancesmallinverse 、 


textappearancemediuminverse 和 textappearancesmall. 


16.4.6 ”邮箱 用 户 检查 
设置 好 邮件 后 ， 单 击 Next 按钮 ， 将 弹出 邮箱 用 户 检查 界面 ， 如 图 16-14 所 示 。 
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Checking outgoing server settin; 


图 16-14 邮箱 用 户 检查 界面 
(1) 编写 文件 AccountCheckSettingsjava， 在 此 定义 邮箱 用 户 检查 界面 ， 主 要 代码 如 下 。 


@ 定义 actionCheckSettings() 方 法 做 数据 初始 化 操作 ，startActivityForResult( 方 法 的 第 

-个 参数 是 一 个 Intent; 第 二 个 参数 是 返回 码 。 通 过 方法 的 不 同 返 回 码 ， 可 以 区 分 不 同 的 

Activity; 当 启 动 了 某 个 Activity 后 ， 返 回 码 依然 关联 着 当前 进程 所 处 理 的 Activity。 当 操 

作 完 成 后 ， 会 有 特定 的 返回 值 作为 响应 某 些 事件 。 即 Activity 执行 finishO 以 后 执行 回调 方 
法 onActivityResult， 而 使 用 startActivity 方法 后 却 不 会 执行 回调 。 对 应 代码 如 下 : 


public class AccountCheckSettings extends Activity implements 
OnClickListener ( 
private static final String EXTRA ACCOUNT - "account"; 
private static final String EXTRA CHECK INCOMING - "checkIncoming"; 
private static final String EXTRA CHECK OUTGOING = "checkOutgoing"; 
private Handler mHandler = new Handler(); 
private ProgressBar mProgressBar; 
private TextView mMessageView; 
private Account mAccount; 
private boolean mCheckIncoming; 
private boolean mCheckOutgoing; 
private boolean mCanceled; 
private boolean mDestroyed; 
public static void actionCheckSettings (Activity context, Account account, 
boolean checkIncoming, boolean checkOutgoing) { 
Intent i = new Intent(context, AccountCheckSettings.class); 
// 为 Account 对 象 的 键 名 赋值 
i.putExtra (EXTRA ACCOUNT, account); 
i.putExtra (EXTRA CHECK INCOMING, checkIncoming); 
i.putExtra (EXTRA CHECK OUTGOING, checkOutgoing) ; 
// 指 定 将 要 启动 的 Activity 的 编号 
context.startActivityForResult(i, 1); 
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© 定义 onCreate 方法 初始 化 窗 体 ， 定 义 了 mProgressBar 控件 ， 该 控件 主要 是 作为 一 
个 进度 条 。mProgressBar 对 和 象 的 setIndeterminate() 方 法 开启 深 动 效果 ，getIntent0 方 法 取得 
当前 Intent 的 信息 实例 ， 然 后 调用 各 get 方法 获取 对 应 的 值 。 对 应 代码 如 下 : 


@override 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView(R.layout.activity account check settings); 
mMessageView = (TextView)findViewById (R.id.message); 
mProgressBar = (ProgressBar) findViewById(R.id.progress) ; 
( (Button) findViewById(R.id.cancel) ) .setOnClickListener (this); 
setMessage(R.string.account setup check settings retr info msg); 
// 打 开 进 度 条 的 滚动 效果 
mProgressBar.setIndeterminate (true); 
mAccount = (Account)getIntent ().getSerializableExtra (EXTRA ACCOUNT); 
mCheckIncoming = (boolean) getIntent () .getBooleanExtra 
(EXTRA CHECK INCOMING, false); 
mCheckOutgoing = (boolean) getIntent () .getBooleanExtra 
(EXTRA CHECK OUTGOING, false); 


© 实例 化 一 个 线程 Thread，setThreadPriority() 方 法 设置 线程 在 后 台 执行 。 程 序 开始 时 
针对 用 户 的 发 送 邮件 进行 检查 ， 如 果 当 前 Activity 状态 处 于 Destroyed 和 Canceled 线程 退 
出 。 对 象 Sender 调用 方法 getImstance0 读 取 用 户 的 URL 信息 ， 然 后 调用 open() 方 法 打开 地 
址 。 如 果 能 够 顺利 地 完成 一 次 close0 和 open() 方 法 的 操作 ， 并 且 不 报 异 常 ， 说 明 用 户 提供 
的 地 址 可 以 正确 使 用 ， 如 图 16-15 所 示 。 对 应 代码 如 下 : 
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Emall checking frequency 


mail from this account by 
default. 


[v DOE when email arrives. 


图 16-15 用 户 检查 成 功 


new Thread() ( 
public void run() ( 
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// 设 置 线程 执行 级 别 
Process.setThreadPriority (Process.THREAD PRIORITY BACKGROUND); 
EEV 4 
if (mDestroyed) { 
return; 


if (mCanceled) { 
finish(); 
return; 


if (mCheckIncoming) { 
setMessage(R.string.account setup check settings 
check incoming msg); 


if (mDestroyed) ( 
return; 


if (mCanceled) ( 
finish(); 
return; 

) 

if (mCheckOutgoing) ( 

setMessage(R.string.account setup check settings 
check outgoing msg); 
Sender sender = Sender.getInstance (mAccount.getSenderUri () ) ; 
sender.close(); 
sender.open(); 
sender.close(); 


if (mDestroyed) ( 
return; 


if (mCanceled) { 
finish(); 
return; 
) 
SetResult (RESULT OK); 
finish(); 


® 在 此 定义 捕获 AuthenticationFailedException 2577, CertificateValidationException 类 
型 和 MessagingException 类 型 的 异常 。 对 应 代码 如 下 : 


} catch (final AuthenticationFailedException afe) { 
String message = afe.getMessage(); 
int id = (message -- null) 
? R.string.account setup failed dlg auth message 
: R.string.account setup failed dlg auth message fmt; 
// 显 示 错误 信息 
showErrorDialog(id, message); 
) catch (final CertificateValidationException cve) ( 
String message = cve.getMessage(); 
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int id = (message == null) 


? R.string.account setup failed dlg certificate message 


: R.string.account setup failed dlg certificate message fmt; 
showErrorDialog(id, message); 

) catch (final MessagingException me) ( 
int id; 
String message = me.getMessage(); 
switch (me.getExceptionType()) { 

case MessagingException.IOERROR: 
id = R.string.account setup failed ioerror; 
break; 

case MessagingException.TLS REQUIRED: 
id = R.string.account setup failed tls required; 
break; 

case MessagingException.AUTH REQUIRED: 
id = R.string.account setup failed auth required; 
break; 

case MessagingException.GENERAL SECURITY: 


id = R.string.account setup failed security; 
break; 

default: 
id = (message == null) 


? R.string.account setup failed dlg server message 


: R.string.account setup failed dlg server message fmt; 
break; 


) 
showErrorDialog(id, message); 


b 
-start (ir. 
} 


© 定义 showErrorDialog() 方 法 显示 错误 对 话 框 ， 具 体内 容 显示 在 AlertDialog 实例 中 
指定 ， 同 时 中 止 进度 条 的 滚动 显示 setIndeterminate(false)， 对 应 代码 如 下 : 


private void showErrorDialog(final int msgResId, final Object. 
mHandler.post(new Runnable() ( 
public void run() ( 
if (mDestroyed) ( 
return; 


args) 


} 

// 关 闭 进度 条 的 滚动 效果 

mProgressBar.setIndeterminate (false); 

// 创 建 一 个 提示 对 话 框 

new AlertDialog.Builder (AccountCheckSettings.this) 
.setIcon(android.R.drawable.ic dialog alert) 


.setTitle(getString(R.string.account setup failed 
dlg title)) 


.setMessage (getString(msgResId, args)) 
.setCancelable (true) 


-setPositiveButton( getString(R.string.account setup 


网 络 开发 从 入 门 到 精通 


failed dlg edit details action), 
new DialogInterface.OnClickListener() ( 
public void onClick(DialogInterface dialog, 
int which) ( 
finish(); 


}) 
-Show() 7 


he 


} 
private void onCancel() { 
mCanceled = true; 
setMessage(R.string.account setup check settings canceling msg); 
) 
public void onClick(View v) ( 
switch (v.getId()) { 
case R.id.cancel: 
onCancel (); 
break; 


} 
(2) 设置 用 户 别名 的 布局 文件 是 activity_account_setup_incoming.xml， 主 要 代码 如 下 


<?xml version-"1.0" encoding-"utf-8"?» 
<LinearLayout 
xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:orientation="vertical"> 
<View 
android:layout width="fill parent" 
android: layout height-"100sp" /> 
<TextView 
android: id="@+id/message" 
android:layout height="wrap content" 
android:layout width="fill parent" 
android:gravity="center horizontal" 
android: textAppearance="?android:attr/textAppearanceMedium" 
android: textColor="?android:attr/textColorPrimary" 
android: paddingBottom="6px" /> 
<ProgressBar 
android: id="@+id/progress" 
android:layout height="wrap content" 
android:layout width="fill parent" 
?android:attr/progressBarStyleHorizontal" /> 


android:layout width="fill parent" 

android:layout height="0px" 

android:layout weight="1" /> 
<RelativeLayout 
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android:layout width-"fill parent" 

android:layout height-"54dip" 

android:background="@android:drawable/menu full frame"> 

<Button 
android: id="@+id/cancel" 
android:text="@string/cancel action" 
android:layout height="wrap content" 
android:layout width="wrap content" 
android:minWidth="100dip" 
android:layout centerVertical="true" /> 

</RelativeLayout> 
</LinearLayout> 


VA EIRIS “android:drawableRight="@drawable/button_indicator_next"” ‘1, drawable 在 
Android SDK 中 的 主要 作用 是 : 在 XML 中 定义 各 种 动画 ， 然 后 把 XML “E drawable 3t 
源 来 读 取 ， 通 过 drawable 显示 动画 。 


1647 ”设置 用 户 别名 


在 成 功 通过 地 址 检测 后 ， 单 击 Next 按钮 ， 将 弹出 设置 用 户 别名 界面 ， 如 图 16-16 所 示 。 


android2. 2 


Your account is set up, and email is 
on its way! 


图 16-16 设置 用 户 别名 界面 


(1) 编写 文件 AccountSetupNames.java， 在 此 定义 设置 用 户 别名 界面 ， 主 要 代码 如 下 。 
(D) 定义 actionSetNames() 方 法 做 数据 初始 化 操作 ，startActivity() 方 法 启动 Activity: 
onCreate() 方 法 定义 两 个 文本 框 组 件 ， 还 定义 setOnClickListener 监听 器 ; validateFields() 方 
法 一 旦 发 现 文本 框 中 的 内 容 都 发 生变 化 后 ， 执 行 监听 器 里 面 的 动作 。 对 应 代码 如 下 : 
public class AccountSetupNames extends Activity implements 
OnClickListener ( 


private static final String EXTRA ACCOUNT = "account"; 
private EditText mDescription; 
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private EditText mName; 

private Account mAccount; 

private Button mDoneButton; 

public static void actionSetNames (Context context, Account account) ( 
/[ } AccountSetupNames 窗 体 的 Rctivity 赋值 
Intent i = new Intent(context, AccountSetupNames.class); 
i.putExtra (EXTRA ACCOUNT, account); 

// 启 动 Account fif 
context.startActivity(i); 

H 

GOverride 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView(R.layout.activity account setup names); 
mDescription = (EditText) findViewById(R.id.account description); 
mName = (EditText) findViewById(R.id.account name); 
mDoneButton = (Button) findViewById(R.id.done) ; 
// 定 义 监听 器 
mDoneButton.setOnClickListener (this); 
TextWatcher validationTextWatcher - new TextWatcher() ( 

public void afterTextChanged(Editable s) ( 
validateFields(); 
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( 调用 mName.setText() 方 法 保存 用 户 名 称 。onNext() 方 法 将 当前 设置 的 用 户 名 保存 在 
Preferences 对 象 中 ， 然 后 Activity 跳 转 到 邮件 编辑 界面 EmailCpsActivity。 对 应 代码 如 下 : 


mName.addTextChangedListener(validationTextWatcher); 
mName.setKeyListener(TextKeyListener.getInstance (false, Capitalize.WORDS)); 
mAccount = (Account)getIntent ().getSerializableExtra (EXTRA ACCOUNT); 
// mDescription.setText (mAccount.getDescription()); 
if (mAccount.getName() != null) { 
mName .setText (mAccount .getName () ) ; 
H 
if (!Utility.requiredFieldValid (mName)) { 
mDoneButton.setEnabled(false); 


} 
private void validateFields() { 
mDoneButton.setEnabled (Utility.requiredFieldValid (mName)); 
Utility.setCompoundDrawablesAlpha (mDoneButton, 
mDoneButton.isEnabled() ? 255 : 128); 
} 
private void onNext() { 
if (Utility.requiredFieldValid (mDescription)) { 
mAccount.setDescription (mDescription.getText ().toString()); 
} 
mAccount.setName (mName.getText ().toString()); 
mAccount . save (Preferences.getPreferences (this)); 
// 定 义 一 个 Activity 47 EmailcpsActivity 
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Intent intent = new Intent (this, EmailCpsActivity.class); 
intent.putExtra (EXTRA ACCOUNT , mAccount); 
/ [38] Activity 
startActivity (intent); 
// 执 行 
finish(); 
} 
public void onClick(View v) { 
switch (v.getId()) { 
case R.id.done: 
onNext () ; 
break; 


} 
(2) 设置 用 户 别 名 的 布局 文件 是 activity account setup names.xml， 主 要 代码 如 下 : 


«?xml version-"1.0" encoding="utf-8"?> 
<LinearLayout 
xmlns:android="http: //schemas .android.com/apk/res/android" 
android:layout width="fill parent" 
android:layout height-"fill parent" 
android:orientation-"vertical"» 
«TextView 
android:text="@string/account setup names instructions" 
android:layout height-"wrap content" 
android:layout width-"fill parent" 
android:textAppearance-"?android:attr/textAppearanceMedium" 
android:textColor-"?android:attr/textColorPrimary" /> 
«TextView 
android:text="@string/account setup names account name label" 
android:layout height-"wrap content" 
android:layout width-"fill parent" 
android:textAppearance-"?android:attr/textAppearanceSmall" 
android:textColor-"?android:attr/textColorPrimary" /> 
<EditText 
android:id="@+id/account description" 
android: inputType="textCapWords" 
android: imeOptions="actionDone" 
android:layout height="wrap content" 
android:layout width="fill parent" /> 
<TextView 
android:text="@string/account setup names user name label" 
android:layout height="wrap content" 
android:layout width="fill parent" 
android: textAppearance="?android:attr/textAppearanceSmall" 
android: textColor="?android:attr/textColorPrimary" /> 
<EditText 
android: id="@+id/account name" 
android: inputType="textPersonName" 
android: imeOptions="actionDone" 
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android:layout height-"wrap content" 
android:layout width-"fill parent" /» 


«View 


android:layout height="0px" 
android:layout width-"fill parent" 
android:layout weight-"1" /> 
<RelativeLayout 
android:layout width="fill parent" 
android:layout height-"54dip" 
android:background="@android:drawable/menu full frame"? 


«Button 
android: id="@+id/done" 
android:text="@string/done action" 
android:layout height="wrap content" 
android:layout width="wrap content" 
android:minWidth="100dip" 
android:layout alignParentRight-"true" 
android:layout centerVertical-"true" /» 
«/RelativeLayout» 
</LinearLayout> 


在 以 上 代码 “android:inputType="textCapWords" ”中 inputType 设置 键盘 类 型 。 
textcapcharacters 代表 字母 大 小 ，numbersigned 代表 有 符号 数字 格式 ，textcapwords 代表 单 
词 首 字母 大 小 ，textcapsentences 代表 仅 第 一 个 字母 大 小 ，textautocomplete 代表 自动 完成 ， 
textmultiline 代表 多 行 输入 ，textimemultiline 代表 输入 法 多 行 ，textnosuggestions 代表 不 提 
示 ，textemailaddress 代表 电子 邮件 地 址 ，textemailsubject 代表 邮件 主题 ，textshortmessage 
代表 短信 息 ，textpersonname 代表 人 名 ，textpostaladdress 代表 地 址 ，textpassword 代表 密 
人 码 ，textvisiblepassword 代表 可 见 密码 ，textwebedittext 代表 作为 网 页 表单 的 文本 ，textfilte 
代表 文本 筛选 过 滤 ，textphonetic 代表 拼音 输入 。 


16.4.8 用 户 邮件 编辑 


在 设置 完 别名 后 ， 单 击 Next 按钮 ， 将 弹出 用 户 邮 件 编辑 界面 ， 如 图 16-17 所 示 。 
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(1) 编写 文件 EmailCpsActivityjava， 在 此 定义 用 户 邮件 编辑 界面 ， 主 要 代码 如 下 。 
(D 定义 Handler 一 个 实例 化 对 象 ， 每 一 个 Handler 类 都 和 一 个 唯一 的 线程 (以 及 这 个 线 


程 的 MessageQueue) 关 联 ， 向 它 所 关联 的 MessageQueue 递送 Messages/Runnables。 它 的 主 
要 用 途 : 按 计划 发 送 消息 或 执行 某 个 Runnable( 使 用 Post 方法 ); 从 其 他 线程 中 发 送 来 的 消 
息 放 入 消息 队列 中 ， 避 免 线 程 冲突 (常见 于 更 新 UI 线程 )。 对 应 代码 如 下 : 


public class EmailCpsActivity extends Activity implements 
OnClickListener, OnFocusChangeListener { 
private static final String EXTRA ACCOUNT = "account"; 
private static final int MSG PROGRESS ON = 1; 
private static final int MSG PROGRESS OFF = 2; 
private static final int MSG UPDATE TITLE = 3; 
private static final int MSG SKIPPED ATTACHMENTS = 4; 
private static final int MSG SAVED DRAFT = 5; 
private static final int MSG DISCARDED DRAFT = 6; 
private Account mAccount; 
private MultiAutoCompleteTextView mToView; 
private MultiAutoCompleteTextView mCcView; 
private MultiAutoCompleteTextView mBccView; 
private EditText mSubjectView; 
private EditText mMessageContentView; 
private Button mSendButton; 
private Button mDiscardButton; 
private ProgressDialog progress; 
private Handler mHandler = new Handler() { 
@override 
public void handleMessage (android.os.Message msg) { 
switch (msg.what) { 

case MSG PROGRESS ON: 

// 开 启 滚动 条 的 滚动 效果 
setProgressBarIndeterminateVisibility (true); 
break; 

case MSG PROGRESS OFF: 

// 关 闭 滚 动 条 的 滚动 效果 
setProgressBarIndeterminateVisibility (false); 
break; 

case MSG UPDATE TITLE: 
updateTitle(); 
break; 

case MSG SKIPPED ATTACHMENTS: 

Toast.makeText ( 
EmailCpsActivity.this, getString(R.string.message 

compose attachments skipped toast), 

Toast.LENGTH LONG).show(); 

break; 

case MSG SAVED DRAFT: 

Toast.makeText ( 
EmailCpsActivity.this, 
getString(R.string.message saved toast), 
Toast.LENGTH LONG).show(); 
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break; 
case MSG DISCARDED DRAFT: 
Toast .makeText ( 
EmailCpsActivity.this, 
getString(R.string.message discarded toast), 
Toast.LENGTH LONG) .show(); 
break; 
default: 
super .handleMessage (msg) ; 
break; 


} 
ye 
private Validator mAddressValidator; 
GOverride 


@ 定义 onCreate() 方 法 做 数据 初始 化 操作 ， 定 义 一 个 MultiAutoCompleteTextView 对 
象 ， 该 对 象 继承 自 AutoCompleteTextView 的 可 编辑 文本 视图 ， 能 够 对 用 户 输入 的 文本 进行 
有 效 地 扩充 提示 ， 而 不 需要 用 户 输入 整个 内 容 。 

@ requestWindowFeature() 方 法 的 功能 是 启用 窗 体 的 扩展 特性 。 参 数 是 Window 类 中 
定义 的 常量 。DEFAULT FEATURES 为 系统 默认 状态 ， 一 般 不 需要 指定 ; FEATURE - 
CONTEXT MENU 为 启用 ContextMenu， 默 认 该 项 已 启用 ， 一般 无 须 指 定 ; 
FEATURE CUSTOM TITLE 为 自 定义 标题 。 当 需要 自 定义 标题 时 必须 指定 。 例 如 : 标题 
是 一 个 按钮 时 ; FEATURE INDETERMINATE PROGRESS 为 不 确定 的 进度 ; 
FEATURE LEFT ICON 为 标题 栏 左 侧 的 图 标 为 FEATURE NO TITLE 为 无 标题 ; 
FEATURE OPTIONS PANEL 为 启用 “选项 面板 ”功能 ， 默 认 已 启用 :; 
FEATURE PROGRESS 为 进度 指示 器 功能 ;， FEATURE RIGHT ICON 为 标题 栏 右 侧 的 图 
标 。 对 应 代码 如 下 : 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
requestWindowFeature (Window.FEATURE INDETERMINATE PROGRESS); 
// 加 载 activity compose.xml 布局 界面 文件 
setContentView(R.layout.activity compose); 
mAddressValidator - new EmailAddressValidator(); 
mToView = (MultiAutoCompleteTextView) findViewById (R.id.to); 
mCcView = (MultiAutoCompleteTextView) findViewById (R.id.cc); 
mBccView = (MultiAutoCompleteTextView)findViewById (R.id.bcc); 
mSubjectView = (EditText)findViewById (R.id.subject); 
mMessageContentView — (EditText)findViewById(R.id.message content); 


mSendButton = (Button) findViewById(R.id.send) ; 
mDiscardButton = (Button) findViewById(R.id.discard) ; 


@ 5E X InputFilterX] 5 [I] Sz HilrecipientFilter 使 用 输入 过 滤器 InputFilter 约 束 用 户 输入 。 
定义 一 个 返回 类 型 为 CharSequence 的 方法 filter 检 查 用 户 的 所 有 输入 是 否 合 法 。 对 应 代码 如 
下 : 


InputFilter recipientFilter = new InputFilter() { 


// 定 义 字 符 过 滤 方 法 
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public CharSequence filter(CharSequence source, int start, int end, 
Spanned dest, 
int dstart, int dend) ( 
if (end-start != 1 || source.charAt(start) = ' ') { 
return null; 
} 
int scanBack = dstart; 
boolean dotFound = false; 
while (scanBack > 0) { 
char c = dest.charAt (--scanBack); 
switch (c) { 
case "ss 
dotFound = true; // one or more dots are req'd 
break; 
case "3": 
return null; 
case 'Q': 
if (!dotFound) ( 
return null; 
) 
if (source instanceof Spanned) ( 
SpannableStringBuilder sb - new 
SpannableStringBuilder(","); 
Sb.append (source) ; 
return sb; 
) else ( 
return" em. 
) 
default: 
// just keep going 


) 
// no termination cases were found, so don't edit the input 


return null; 


n 
InputFilter[] recipientFilters = new InputFilter[] { recipientFilter }; 
// NOTE: assumes no other filters are set 


© 将 输入 过 滤器 作用 于 mToView. mCcView. mBccView, mToView, mToView 和 
mCcView 组 件 之 上 。setOnFocusChangeListener 方法 将 焦点 定位 于 该 组 件 上 ， 为 “发 送 ” 
和 “取消 ”按钮 定义 setOnClickListener 监听 器 。 对 应 代码 如 下 : 

// 为 组 件 指定 过 滤 规 则 


mToView.setFilters (recipientFilters); 
mCcView.setFilters (recipientFilters); 
mBccView.setFilters (recipientFilters); 
mToView.setTokenizer(new Rfc822Tokenizer()); 
mToView.setValidator (mAddressValidator); 
mCcView.setTokenizer(new Rfc822Tokenizer()); 
mCcView.setValidator (mAddressValidator) ; 
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mBccView.setTokenizer (new Rfc822Tokenizer()):; 
mBccView.setValidator (mAddressValidator); 
mSendButton.setOnClickListener (this); 
mDiscardButton.setOnClickListener (this); 
mSubjectView.setOnFocusChangeListener (this); 
Intent intent - getIntent(); 
mAccount = (Account) intent.getSerializableExtra (EXTRA ACCOUNT); 
updateTitle(); 

} 

GOverride 

// 暂 停 后 恢复 调用 

public void onResume() ( 
super.onResume () ; 

} 

@override 

// 暂 停 

public void onPause() ( 
super.onPause(); 

) 

@override 

/ B 

public void onDestroy() ( 
super.onDestroy(); 

) 

private void updateTitle() ( 


if (mSubjectView.getText().length() == 0) ( 
setTitle(R.string.compose title); 
) else ( 


setTitle (mSubjectView.getText () .toString()); 
} 
} 
// 焦 点 发 生变 化 
public void onFocusChange(View view, boolean focused) ( 
if (!focused) ( 
updateTitle(); 


} 
private Address[] getAddresses (MultiAutoCompleteTextView view) ( 
Address[] addresses = Address.parse(view.getText().toString().trim()); 
return addresses; 
} 
© 定义 一 个 MimeMessage X% message 实例 ， 类 MimeMessage 继承 自 定义 类 
Message， 封 装 邮件 发 送 时 的 信息 。 调 用 setFrom() 方 法 、setRecipients() 方 法 和 setSubject() 
方法 进行 邮件 信息 头 封装 操作 。 定 义 一 个 TextBody 对 象 body 实例 ， 调 用 setBody() 方 法 将 
文本 内 容 写 入 其 中 。 对 应 代码 如 下 : 


private MimeMessage createMessage() throws MessagingException { 


MimeMessage message = new MimeMessage(); 
message.setSentDate (new Date()); 
Address from = new Address (mAccount.getEmail(), mAccount.getName()); 
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message.setFrom(from); 
message.setRecipients (RecipientType.TO, getAddresses (mToView)); 
message.setRecipients (RecipientType.CC, getAddresses (mCcView)); 
message.setRecipients (RecipientType.BCC, getAddresses (mBccView)); 
message.setSubject (mSubjectView.getText () .toString()); 
String text = mMessageContentView.getText () .toString(); 
// 输 出 日 志 信息 
Log.d(Email.LOG TAG, text); 
TextBody body - new TextBody (text); 
message.setBody (body) ; 
return message; 
} 
private void sendMessage() { 
// 定 义 一 个 进度 条 
progress = ProgressDialog.show(this, "", "sending..."); 
final MimeMessage message; 
try ( 
message = createMessage():; 
} 
catch (MessagingException me) { 
// 打 出 日 志 
Log.e(Email.LOG TAG, "Failed to create new message for send or 
save.", me); 
throw new RuntimeException("Failed to create a new message for 
send or save.", me); 
} 
Thread thread = new Thread (new Runnable() { 
@override 
public void run() { 
try ( 
Sender sender - Sender.getInstance 
(mAccount.getSenderUri()); 

ArrayList<Part> viewables = new ArrayList<Part>(); 
ArrayList<Part> attachments = new ArrayList<Part>(); 
MimeUtility.collectParts (message, viewables, attachments); 
StringBuffer sbHtml - new StringBuffer(); 
StringBuffer sbText - new StringBuffer(); 
for (Part viewable : viewables) ( 

try ( 
String text = MimeUtility.getTextFromPart (viewable); 
/* 
* Anything with MIME type text/html will be stored 
as such. Anything 
* else will be stored as text/plain. 
ey! 
if (viewable.getMimeType ().equalsIgnoreCase 
("text/htm1")) ( 
sbHtml.append (text); 
) 
else ( 
sbText.append (text); 
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) 
) catch (Exception e) ( 
throw new MessagingException("Unable to get text for 
message part", e); 
) 
} 


message.setUid("email" + UUID.randomUUID().toString()); 
message.setHeader(MimeHeader.HEADER CONTENT TYPE, "multipart/mixed"); 
MimeMultipart mp = new MimeMultipart (); 
mp.setSubType ("mixed"); 
message.setBody (mp) ; 
String htmlContent = sbHtml.toString(); 
String textContent = sbText.toString(); 
if (htmlContent != null) { 


TextBody body = new TextBody (htmlContent); 
MimeBodyPart bp = new MimeBodyPart (body, "text/html"); 
mp.addBodyPart (bp) ; 


Log.v(Email.LOG TAG, htmlContent) ; 
) 


if (textContent != null) { 


TextBody body = new TextBody (textContent); 
MimeBodyPart bp = new MimeBodyPart (body, "text/plain") 7 
mp .addBodyPart (bp) ; 


Log.v(Email.LOG TAG, textContent) ; 

} 
// 发 送信 息 

sender .sendMessage (message) ; 

} catch (MessagingException e) { 

e.printStackTrace(); 

} 

progress.dismiss(); 

finish(); 


p; 
thread.start(); 
) 


C) WE Toast 是 Android 中 用 来 显示 信息 的 一 种 机 制 ， 它 和 Dialog 有 所 不 同 ，Toast 
没有 焦点 ， 而 且 显示 的 时 间 很 得， 在 一 定 的 时 间 后 就 会 自动 消失 。sendMessage(0 正 式 进行 
邮件 发 送 操作 。 对 应 代码 如 下 : 


private void onSend() ( 
if (getAddresses (mToView).length == 0 && 
getAddresses (mCcView) . length 0 && 
getAddresses (mBccView).length 0) ( 


mToView.setError(getString(R.string.message compose error 
no recipients)); 


Toast.makeText(this, getString(R.string.message compose error 
no recipients), 


Toast.LENGTH LONG).show(); 
return; 
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} 
sendMessage () ; 


} 
// 发 送信 息 主 方法 
private void onDiscard() { 
mHandler.sendEmptyMessage (MSG DISCARDED DRAFT); 
finish(); 
} 
public void onClick(View view) ( 
switch (view.getId()) ( 
case R.id.send: 
onSend () ; 
break; 
case R.id.discard: 
onDiscard(); 
break; 


) 
@override 
public boolean onOptionsItemSelected(MenuItem item) { 
switch (item.getItemId()) { 
case R.id.send: 
onSend(); 
break; 
case R.id.discard: 
onDiscard(); 
break; 
default: 
return super.onOptionsItemSelected (item) ; 
} 
return true; 


} 


(2) 用 户 邮 件 编辑 的 布局 文件 是 activity_compose.xml， 主 要 代码 如 下 。 

口 ” 以 下 代码 中 android:scrollbarStyle="outsideInset" 设 置 滚动 条 的 风格 ， 

Q  android:fillViewport-"true" ， 当 定义 scrollview 的 子 控件 不 足 scrollbarStyle 大 小 
时 ， 对 其 设 定 fill parent 属性 时 不 起 作用 ， 此 时 必须 加 fillviewport 属性 。 对 应 代 
码 如 下 : 


«?xml version-"1.0" encoding-"utf-8"?» 
<LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout height-"fill parent" android:layout width-"fill parent" 
android:orientation-"vertical"» 
<ScrollView android:layout width-"fill parent" 
android:layout height="wrap content" android:layout weight="1" 
android:scrollbarStyle-"outsideInset" 
android:fillViewport-"true"» 
<LinearLayout android:orientation-"vertical" 
android:layout width-"fill parent" 
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android:layout height-"wrap content"> 


<LinearLayout android:orientation-"vertical" 

android:layout width-"fill parent" 

android:layout height="wrap content" android:background="#ededed"> 

<MultiAutoCompleteTextView 
android:id="@+id/to" android:layout width="fill parent" 
android:layout height="wrap content" 
android: textAppearance="?android:attr/textAppearanceMedium" 
android: textColor="?android:attr/textColorSecondaryInverse" 
android:layout marginLeft="6px" 
android:layout marginRight="6px" 
android: inputType="textEmailAddress|textMultiLine" 
android: imeOptions="actionNext" 
android:hint="@string/message compose to hint" /> 


Q  android:hint="@string/message_compose_bec_hint", i EditText 为 空 时 提示 信息 。 
ū ”android:visibility="gone"， 表 示 此 视图 是 否 显示 。 三 个 属性 分 别 是 ，visible 显示 ; 
invisible 显示 黑 背 景 条 ; gone 不 显示 。 对 应 代码 如 下 : 


<MultiAutoCompleteTextView 
android:id="@+id/cc" android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:textAppearance-"?android:attr/textAppearanceMedium" 
android:textColor-"?android:attr/textColorSecondaryInverse" 
android:layout marginLeft-"6px" 
android:layout marginRight-"6px" 
android:inputType-"textEmailAddress|textMultiLine" 
android:imeOptions-"actionNext" 
android:hint="@string/message compose cc hint" 
android:visibility-"gone" /» 

<MultiAutoCompleteTextView 
android: id="@+id/bcc" android:layout width-"fill parent" 
android:layout height="wrap content" 
android: textAppearance="?android:attr/textAppearanceMedium" 
android: textColor="?android:attr/textColorSecondaryInverse" 
android:layout marginLeft="6px" 
android:layout marginRight="6px" 
android: inputType="textEmailAddress|textMultiLine"” 
android: imeOptions="actionNext" 
android:hint="@string/message compose bcc hint" 
android:visibility="gone" /> 


Q  androidinputType-"textEmailSubject|textAutoCorrect|textCapSentences|textImeMulti 
Line"， 设 置 键盘 输入 类 型 。 多 种 类 型 同时 定义 时 用 “ | ”分 隔 符 。 

Q  android:gravity-"top" , ix fb fs bie B. BAA center( 居 中 )、 
bottom( F), top( E). right(£:)l left( 左 )， 如 定义 左下 的 效果 android:gravity= 
" left| bottom "。 对 应 代码 如 下 : 


<EditText android:id="@+id/subject" 
android:layout width-"fill parent" 
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android:textAppearance="?android:attr/textAppearanceMedium" 
android:layout height-"wrap content" 
android:textColor-"?android:attr/textColorSecondaryInverse" 
android:layout marginLeft-"6px" 
android:layout marginRight-"6px" 
android:hint="@string/message compose subject hint" 
android: inputType="textEmailsubject|textAutoCorrect| 
textCapSentences|textImeMultiLine" 

android: imeOptions="actionNext" 
/> 

<LinearLayout android:id="@+id/attachments" 
android:layout width="fill parent" 
android:layout height="wrap content” 
android:orientation="vertical" /> 

«View android:layout width="fill parent" 
android:layout height="1px" 
android:background="@drawable/divider horizontal email" /> 

</LinearLayout> 
<EditText android: id="@+id/message content" 

android: textColor="?android:attr/textColorSecondaryInverse" 

android:layout width="fill parent" 

android:layout height="wrap content" 

android:layout weight="1.0" 

android:gravity-"top" 

android:textAppearance-"?android:attr/textAppearanceMedium" 

android:hint="@string/message compose body hint" 

android:inputType-"textMultiLine|textAutoCorrect | textCapSentences" 

android: imeOptions="actionDone|flagNoEnterAction" 

/> 

</LinearLayout> 
«/ScrollView» 


Q  android:paddingTop-"5dip", padding 是 站 在 父 组 件 view 的 角度 指定 空间 位 置 ， 规 
定 里 面 的 内 容 必 须 与 这 个 父 view 边界 的 距离 。margin 则 是 根据 控件 自身 指定 空 
间 位 置 ， 设 定 其 他 (上 、 下 、 左 、 右 ) 的 view 之 间 的 距离 。 对 应 代码 如 下 : 


<LinearLayout 
android: orientation="horizontal" 
android:layout width="fill parent" 
android:layout height="wrap content" 
android: paddingTop="5dip" 
android: paddingLeft="4dip" 
android: paddingRight="4dip" 
android:paddingBottom-"1dip" 
android:background="@android:drawable/menu full frame" > 
«Button 
android: id="@+id/send" 
android:text="@string/send action" 
android:layout height="fill parent" 
android:layout width="wrap content" 
android: layout_weight="1" /> 
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«Button 
android:id-"(*id/discard" 
android:text="@string/discard action" 
android:layout height-"fill parent" 
android:layout width-"wrap content" 
android:layout weight-"1" /» 
</LinearLayout> 
</LinearLayout> 


16.5 打包 、 签 名 和 发 布 


当 一 个 Android 项 目 开发 完毕 后 ， 需 要 打包 和 签名 处 理 ， 这 样 才能 放 到 手机 中 使 用 ， 
当然 也 可 以 发 布 到 Market 上 去 赚钱 。 下 面 开始 讲解 打包 、 签 名 、 发 布 Android 程序 的 具体 


16.5.1 ”申请 会 员 


申请 会 员 即 去 Market 申请 成 为 会 员 ， 具 体 流程 如 下 。 
(1) 登录 http://market.android/publish/signup， 如 图 16-18 所 示 。 


2 market 


Distribute your applications to users of Android mobile phones. 


Sign in with your 


Android Market enables developers to easily publish and distribute their applications directly to Google Account 
users of Android-compatible phones 
Email 
D Come one. Come all. Fe [ 7] 
Android Market is open to all Android application developers. Once registered. 
developers have complete control over when and how they make their applications F Stay signed in 


available to users Lsunv | 


Easy and simple to use. 
Start using Android Market in 3 easy steps: register, upload, and publish 


Great visibility. 

Developers can easily manage their application portfolio where they can view 
information about downloads, ratings and comments. Develop 
publish updates and new versions of their apps. 


Cant access your account? 


Don't have a Google 
Account? 
Create an account now 


in also easily 


To leam more about how to use Android Market, visit the Android Market help 
center. 


i 
be | set BER 


16-18 ”登录 Market 
(2) 单 击 Create an account now 链接 ， 来 到 注册 页 面 ， 如 图 16-19 所 示 。 
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ETT FT SEW AR SED IRAD ED 
OF c x ax oe 
B © | @ 使 用 火狐 中 国 版 $ 使 用 火狐 中 国 版 D 访 问 最 多 @ KFH s 景 新 头条 
AY Google Accounts + 


Create an Account a 


Your Google Account gives you access to Android Market Publisher Site and other Google services. If you already have 
a Google Account, you can sign in here. 


Required information for Google account 


Your current email address: 


e.g. myname@example.com. This will be used to sign-in to your 


account 
Choose a password: Password strength: 
Minimum of 8 characters in length. 


nter password: | se 


E Stay signed in 


Creating a Google Account will enable Web History. Web History is a 
feature that will provide you with a more personalized experience on 
Google that includes more relevant search results and 
recommendations. Learn More 


F Enable Web History. 


Get started with Android Market Publisher Site 

Location: [pane eran a 
Change | 

Birthday: | | 


zi 
BER 7 


图 16-19 注册 页 面 


(3) 单 击 同意 协议 按钮 后 进入 下 一 步 的 页 面 ， 在 此 输入 手机 号 码 ， 如 图 16-20 所 示 。 


‘Account verification helps with: 一 


* Preventing spam: we try to verify that real people, not robots, are creating accounts 
© Recovenng account access: we 
access to your account. 
© Communication: we will use your information to notify you of important changes to your account 
(for example, password changes fram a new location) 


il use your information to verify your idantity if you ever lose. 


Unless you explicitly tell us to do so, your phone number will never be sold or shared wi 
other companies, and we will not use it for any purpose other than during this verification step. 
and for password recovery and account security issues. In other words, you dont have to worry 
about getting soam calls or text messages from us, ever. 


For more information, please read our frequently asked quastions 


Verification Options 


€ Text Message 

Google wil send a text message cortainirg a verification code to your motile phone. 
© Voice Call 

Google wil make an automated voice call to your phone wth a verification code. 


Country 


China (中 国 ) B 


Mobile phone number 


I 


Send verification code to my mobile phone 


EET 


I| 
GRR 
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(4) 在 新 打开 的 页 面 中 输入 手机 获取 的 验证 码 ， 如 图 16-21 所 示 。 


文件 FE) RED SEV PLO SEQ IAD 帮助 如 


BH e x e x @ BI/ eae renean 


B € sueems $ 使 用 火狐 中 国 版 于 访问 最 多 @ 新 于 上 路 A BHR 
ZEY | 不 记录 本 站 点 | wro |B 


Mttps: /eee. geo--dreiddeveloper | + | 
OO 你 起 让 Firefox 记 住 “bjrrny1238126. con” E google. con UST 


If you dont receive the message, try sending it again 


Enter your code 
80860 引 


Verity | 
If you're having trouble verifying your account, please report your issue 


BH 
pé | sent BRR, 


图 16-21 输入 验证 码 
(5) 验证 通过 后 ， 在 新 打开 的 页 面 中 继续 输入 信息 ， 如 图 16-22 所 示 。 


文件 下 dec) EEV PLO HEV IAD Woo 


6 * C X HX E Dh/ wrod con/publi shi oil iue 4 be 
Bj © | @ ensem @ CREME a 访问 是 多 @ 新 手 上 路 o 最 新 头条 à 
| Developer Signup [*] | 
Listing Details 
Your developer profile wili determine how you appear to customers in the Android Market 
Developer Name — [fuanxijine 
Will appear to users under the name of your application 
Email Address — [bjrzny1238126. con 
Website URL [http://www 126. con 
Phone Number 13475959369 
Include country code and area code. why do we ask for this? 
Email updates — Contact me occasionally about development and Market opportunities. 
Continue » 
ie | FR 
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(6) itt Continue 按钮 后 ， 提 示 需 要 花费 25 美元 ， 支 付 后 才能 成 为 正式 会 员 ， 如 图 16-23 
所 示 。 
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XPD MED 查看 
6 C X me X E omm android con/publish/si gup 
B o|esuems $ emuuKqeES o 访问 最 多 @ 新 手 上 路 三 .最新 头条 
| || Developer Signup + 
E 
Register as a developer 
Registration fee: $25.00 
Your registration fee enables you to publish software in the market. The name and billing address used to register will bind you to the Android Market 
Developer Distribution Agreement. So make sure you double check! ee 
Pay your registration fee with 
| Googe 
到 
LIE I 


16-23 ”提示 支付 页 面 


c» a CED e acu i, WA 1624 所 示 。 


1 Android - Developer Registration Fee for bjzny123@126 com $25.00 E 


Subtotal: $25.00 


Shipping and Tax calculated on next page 


Add a credit card to your Google Account to continue 
Shop confidently with Google Checkout 
Sign up now and get 100% protection on unauthorized purchases while 
shopping at stores across the web. 
Email bjrzny123@126.com Signin ss a dtterert user 
Location: [United States a 
Dont see your country? Learn More 
Card number: [EJ 
Expiration date Month x] /[Year E] cvc wate mie 


Cardholder name: 


Billing Address | FE 


City/Town: [ 

State [Select state X 

Zip: 12) [ 3 
DEJ Gas, 


图 16-24 支付 界面 
在 此 输入 你 的 信用 卡 信息 ， 完 成 支付 后 即 可 成 为 正式 会 员 


16.5.0 ”生成 签名 文件 


Android 程序 的 签名 和 Symbian 类 似 ， 都 可 以 自 签名 (Self-signed)， 但 是 在 Android 平 


2 
o 


> Andicid sss num 


台中 ， 证 书 初 期 还 显得 形同虚设 ， 平 时 开发 时 通过 ADB 接口 上 传 的 程序 会 自动 被 签 有 
Debug 权限 的 程序 。 在 需要 签名 验证 上 传 程序 到 Android Market 上 时 大 家 都 已 经 发 现 这 个 
问题 了 。 

Android 签名 文件 的 制作 方法 有 以 下 两 种 。 

1. 命令 行 生 成 

具体 流程 如 下 。 

(1) 执行 如 下 cmd 命令 : 

keytool -genkey -alias androidl23.keystore -keyalg RSA -validity 20000 - 

keystore android123.keystore 

然后 依次 提示 用 户 输入 以 下 信息 : 

输入 keystore 密码 : [密码 不 回 显 ] 

再 次 输入 新 密码 : [密码 不 回 显 ] 

您 的 名 字 与 姓氏 是 什么 ? 

[Unknown]: android123 

您 的 组 织 单位 名 称 是 什么 ? 

[Unknown]: www.android123.com.cn 

您 的 组 织 名 称 是 什么 ? 

[Unknown]: www.android123.com.cn 

您 的 组 织 名 称 是 什么 ? 

[Unknown]: www.android123.com.cn 

您 所 在 的 城市 或 区 域名 称 是 什么 ? 

[Unknown]: New York 

您 所 在 的 州 或 省 份 名 称 是 什么 ? 

[Unknown]: New York 

该 单位 的 两 字母 国家 代码 是 什么 

[Unknown]: CN 

CN=android123, OU=www.android123.com.cn, O=www.android123.com.cn, L=New York, 
ST=New York, C-CN 正确 吗 ? 

[S] Y 
输入 <android123 .keystore> 的 主 密码 (如 果 和 keystore 密码 相同 ， 按 回 车 ): 

其 中 参数 -validity 为 证 书 有 效 天 数 ， 这 里 我 们 写 200 天 。 还 有 在 输入 密码 时 没有 回 
显 ， 只 管 输入 就 可 以 了 ， 一 般 位 数 建议 使 用 20 位 ， 最 后 需要 记 下 来 后 面 还 要 用 。 接 下 来 
就 可 以 为 apk 文件 签名 了 。 

Q) 执行 : 

jarsigner -verbose -keystore androidl23.keystore -signedjar 

android123 signed.apk android123.apk android123.keystore 

这 样 就 可 以 生成 签名 的 apk 文件 ， 假 设 输入 文件 android123.apk， 则 最 终生 成 
android123 signed.apk 为 Android 签名 后 的 APK 执行 文件 。 
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注意 : keytool 用 法 和 jarsigner 的 用 法 总 结 。 
(1) keytool 用 法 : 
-Certreq [-v] [-protected] 

[-alias < 别名 >] [-sigalg <sigalg>] 

[-file <csr_file>] [-keypass < 密 钥 库 口令 >] 

[-keystore < 密 钥 库 >] [-storepass < 存储 库 口 令 >] 

[-storetype < 存储 类 型 >] [-providername < 名 称 >] 

[-providerclass < 提供 方 类 名 称 > [-providerarg < 参数 >]] … 

[-providerpath < 路 径 列表 >] 


-changealias [-v] [-protected] -alias < 别名 > -destalias < 目标 别名 > 
[-keypass < 密 钥 库 口 令 >] 
[-keystore < 密 钥 库 >] [-storepass < 存储 库 口 令 >] 
[-storetype < 存储 类 型 >] [-providername < 名 称 >] 
[-providerclass < 提供 方 类 名 称 > [-providerarg < 参数 >]] ... 
[-providerpath < 路 径 列表 >] 


-delete [-v] [-protected] -alias < 别名 > 
[-keystore < 密 钥 库 >] [-storepass < 存储 库 口 令 >] 
[-storetype < 存储 类 型 >] [-providername < 名 称 >] 
[-providerclass < 提供 方 类 名 称 > [-providerarg < 参数 >]] ... 
[-providerpath < 路 径 列 表 >] 


-exportcert [-v] [-rfc] [-protected] 
[-alias < 别名 >] [-file < 认证 文件 >] 
[-keystore < 密 钥 库 >] [-storepass < 存储 库 口 令 >] 
[-storetype < 存储 类 型 >] [-providername < 名 称 >] 
[-providerclass < 提供 方 类 名 称 > [-providerarg < 参数 >]] ... 
[-providerpath < 路 径 列 表 >] 


-genkeypair [-v] [-protected] 
[-alias < 别名 >] 
[-keyalg <keyalg>] [-keysize < 密 钥 大 小 >] 
[-sigalg <sigalg>] [-dname <dname>] 
[-validity <valDays>] [-keypass < 密 钥 库 口令 >] 
[-keystore < 密 钥 库 >] [-storepass < 存储 库 口 令 >] 
[-storetype < 存储 类 型 >] [-providername < 名 称 >] 
[-providerclass < 提供 方 类 名 称 > [-providerarg < 参数 >]] ... 
[-providerpath < 路 径 列表 >] 
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-genseckey  [-v] [-protected] 
[-alias < 别名 >] [-keypass < 密 钥 库 口令 >] 
[-keyalg <keyalg>] [-keysize < 密 钥 大 小 >] 
[-keystore < 密 钥 库 >] [-storepass < 存储 库 口 令 >] 
[-storetype < 存储 类 型 >] [-providername < 名 称 >] 
[-providerclass < 提供 方 类 名 称 > [-providerarg < 参数 >]] … 
[-providerpath < 路 径 列 表 >] 


-help 

-importcert [-v] [-noprompt] [-trustcacerts] [-protected] 
[-alias < 别名 >] 
[-file < 认证 文件 >] [-keypass < 密 钥 库 口令 >] 
[-keystore < 密 钥 库 >] [-storepass < 存储 库 口 令 >] 
[-storetype < 存储 类 型 >] [-providername < 名 称 >] 
[-providerclass < 提供 方 类 名 称 > [-providerarg < 参数 >]] ... 
[-providerpath < 路 径 列 表 >] 


-importkeystore [-v] 

[-srckeystore < 源 密 钥 库 >] [-destkeystore < 目标 密 钥 库 >] 
[-srcstoretype < 源 存储 类 型 >] [-deststoretype < 目标 存储 类 型 >] 
[-srcstorepass < 源 存储 库 口 令 >] [-deststorepass < 目标 存储 库 口 令 >] 
[-srcprotected] [-destprotected] 
[-srcprovidername < 源 提 供 方 名 称 >] 
[-destprovidemame < 目标 提供 方 名 称 >] 
[-srcalias < 源 别名 > [-destalias < 目标 别名 >] 

[-srckeypass < 源 密 钥 库 口令 >] [-destkeypass < 目标 密 钥 库 口令 >]] 
[-noprompt] 
[-providerclass < 提供 方 类 名 称 > [-providerarg < 参数 >]] .… 
[-providerpath < 路 径 列 表 >] 


-keypasswd — [-v] [-alias < 别名 >] 
[-keypass < 旧 密 钥 库 口令 >] [-new < 新 密 钥 库 口 令 >] 
[-keystore < 密 钥 库 >] [-storepass < 存储 库 口 令 >] 
[-storetype < 存储 类 型 >] [-providemame < 名 称 >] 
[-providerclass < 提供 方 类 名 称 > [-providerarg < 参数 >]] .… 
[-providerpath < 路 径 列表 >] 


-list [-v | fc] [-protected] 
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[-alias < 别名 >] 
[-keystore < 密 钥 库 >] [-storepass < 存储 库 口令 >] 
[-storetype < 存储 类 型 >] [-providername < 名 称 >] 


[-providerclass < 提供 方 类 名 称 > [-providerarg < 参数 >]] ... 


[-providerpath < 路 径 列表 >] 


-printcert — [-v] [-file < 认证 文件 >] 


-storepasswd [-v] [-new < 新 存储 库 口令 >] 
[-keystore < 密 钥 库 >] [-storepass < 存储 库 口 令 >] 
[-storetype < 存储 类 型 >] [-providername < 名 称 >] 


[-providerclass < 提供 方 类 名 称 > [-providerarg < 参数 >]] ... 


[-providerpath < 路 径 列表 >] 


(2) jarsigner 用 法 : 
[选项 ] jar 文件 别名 


jarsigner -verify [选项 ] jar 文件 


[-keystore <url>] 
[-storepass < 口令 >] 
[-storetype < 类 型 >] 
[-keypass < 口令 >] 
[-sigfile < 文件 >] 
[-signedjar < 文件 >] 
[-digestalg < 算法 >] 
[-sigalg < 算法 >] 
[-verify] 

[-verbose] 

[-certs] 

[-tsa <url>] 
[-tsacert < 别名 >] 
[-altsigner < 类 >] 


密 钥 库 位 置 

用 于 密 钥 库 完整 性 的 口令 
密 钥 库 类 型 

专用 密 钥 的 口令 (如 果 不 同 ) 
.SF/.DSA 文件 的 名 称 

已 签名 的 JAR 文件 的 名 称 
摘要 算法 的 名 称 

签名 算法 的 名 称 
验证 已 签名 的 JAR 文件 
签名 /验证 时 输出 详细 信息 
输出 详细 信息 和 验证 时 显示 证 书 
时 间 戳 机 构 的 位 置 

时 间 戳 机 构 的 公共 密 钥 证 书 
替代 的 签名 机 制 的 类 名 


[-altsignerpath < 路 径 列表 >] 替代 的 签名 机 制 的 位 置 


[-internalsf] 
[-sectionsonly] 
[-protected] 
[-providerName < 名 称 >] 
[-providerClass < 类 >] 
[-providerArg < 参数 >] .… 


在 签名 块 内 包含 .SF 文件 
不 计算 整个 清单 的 散 列 

密 钥 库 已 保护 验证 路 径 
提供 者 名 称 

加 密 服 务 提 供 者 的 名 称 

主 类 文件 和 构造 函数 参数 


实际 上 ， 使 用 Eclipse 可 以 更 加 直观 、 方 便 地 生成 签名 文件 ， 具 体 流程 如 下 。 
(1) Aik Eclipse 项 目 名 ， 依 次 选择 Android Tools | Export Signed Application Package 
命令 ， 如 图 16-25 所 示 。 


[2010-06-14 14:12: 


图 16-25 ”选择 导出 
Q) 在 打开 的 对 话 框 中 选择 要 导出 的 项 目 ， 如 图 16-26 所 示 。 


Project Checks 


Performs a set of checks to make sure the application can be exported —— 


图 16-26 选择 要 导出 的 项 目 


(3) 单 击 Next 按钮 ， 在 弹出 的 对 话 框 中 选中 Create new keystore 单 选 按钮 ， 然 后 分 别 
输入 文件 名 和 密码 ， 如 图 16-27 所 示 。 


16-27 输入 文件 名 和 密码 
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(4) 单 击 Next 按钮 ， 在 弹出 的 对 话 框 中 输入 签名 文件 路 径 ， 如 图 16-28 所 示 。 


16-28 ”输入 签名 文件 路 径 


(5) 单 击 Next 按钮 ， 在 弹出 的 对 话 框 中 依次 输入 签名 文件 的 相关 信息 ， 如 图 16-29 所 示 。 


| 
| 


| 
| 
i 


16-29 ”输入 签名 文件 的 相关 信息 
(6) 单 击 Next 按钮 后 完成 签名 文件 的 创建 。 


16.5.3 ”使 用 签名 文件 


生成 签名 文件 后 ， 就 可 以 使 用 它 了 。 有 以 下 两 种 使 用 方式 。 

(假设 生成 的 签名 文件 是 ChangeBackgroundWidgetapk ， 则 最 终生 成 
ChangeBackgroundWidget signed.apk 为 Android 签名 后 的 APK 执行 文件 。 

输入 以 下 命令 行 : 

jarsigner -verbose -keystore ChangeBackgroundWidget.keystore -signedjar 

ChangeBackgroundWidget signed.apk ChangeBackgroundWidget.apk 
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ChangeBackgroundWidget.keystore 


上 面 命令 中 间 不 换行 。 
(2) 按 Enter 键 ， 根 据 提示 输入 密 钥 库 的 口令 短语 ( 即 密码 )， 详 细 信 息 如 下 : 
输入 密 钥 库 的 口令 短语 : 

正在 添加 :  META-INF/MANIFEST.MF 

正在 添加 : META-INF/CHANGEBA. SF 

正在 添加 : META-INF/CHANGEBA.RSA 

正在 签名 : res/drawable/icon.png 

正在 签名 : res/drawable/icon audio.png 
正在 签名 : res/drawable/icon exit.png 
正在 签名 : res/drawable/icon folder.png 
正在 签名 : res/drawable/icon home.png 
正在 签名 : res/drawable/icon img.png 
正在 签名 : res/drawable/icon left.png 
正在 签名 : res/drawable/icon mantou.png 
正在 签名 : res/drawable/icon other.png 
正在 签名 : res/drawable/icon pause.png 
正在 签名 : res/drawable/icon play.png 
正在 签名 : res/drawable/icon return.png 
正在 签名 : res/drawable/icon right.png 
正在 签名 : res/drawable/icon set.png 
正在 签名 : res/drawable/icon text.png 
正在 签名 : res/drawable/icon xin.png 
正在 签名 : res/layout/fileitem.xml 

正在 签名 : res/layout/filelist.xml 

正在 签名 : res/layout/main.xml 

正在 签名 : res/layout/widget.xml 

正在 签名 : res/xml/widget info.xml 

正在 签名 : AndroidManifest.xml 

正在 签名 : resources .arsc 


正在 签名 : classes .dex 

通过 上 述 过 程 处 理 后 ， 即 可 将 未 签名 文件 ChangeBackgroundWidgetapk 签名 为 
ChangeBackgroundWidget signed.apk. 

在 上 述 方式 中 ， 读 者 可 能 会 遇 到 以 下 问题 。 

问题 一 : jarsigner 无 法 打开 jar 文件 ChangeBackgroundWidget.apk. 

解决 方法 : 将 要 进行 签名 的 APK 放 到 对 应 的 文件 下 ， 把 要 签名 的 
ChangeBackgroundWidget.apk 放 到 JDK 的 bin 文件 里 。 

问题 二 : jarsigner 无 法 对 jar 进行 签名 : 

java.util.zip.ZipException: invalid entry comp 

ressed size (expected 1598 but got 1622 bytes) 

方法 一 : Android 开发 网 提示 这 些 问题 主要 是 由 于 资源 文件 造成 的 ， 对 于 Android 开发 
来 说 应 该 检查 res 文件 夹 中 的 文件 ， 逐 个 排查 。 这 个 问题 可 以 通过 升级 系统 的 JDK 和 TRE 
版 本 来 解决 。 

方法 二 : 这 是 因为 默认 给 APK 做 了 debug 签名 ， 所 以 无 法 做 新 的 签名 ， 这 时 就 必须 
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右 击 工程 ， 在 弹出 的 快捷 菜单 中 选择 Android Tools | Export Unsigned Application Package 
命令 。 
或 者 从 AndroidManifestxml 的 Exporting 上 也 是 一 样 的 。 
然后 再 基于 这 个 导出 的 unsigned apk 做 签名 ， 导 出 的 时 候 最 好 将 其 目录 选 在 你 之 前 产 
生 keystore 的 那个 目录 下 ， 这 样 操作 起 来 就 方便 了 。 


16.5.4 发 布 


发 布 的 过 程 比 较 简单 ， 来 到 Market， 登 录 个 人 中 心 ， 上 传 签 名 后 的 文件 即 可 。 具 体操 
作 流 程 在 Market 站 点 上 有 详细 的 介绍 说 明 。 为 节省 本 书 的 篇 幅 ， 在 此 将 不 做 详细 介绍 。 


